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.
SCPI COMMAND REFERENCE
The Keysight DSOX2002A is Keysight's oscilloscope in the InfiniiVision 2000 X-Series family. Its SCPI remote-control interface exposes 527 commands across 50 subsystems - 525 settable and 2 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.
527
Commands
525
Settable
2
Queries
50
Subsystems
SCPI
Verified
2026-07-16
All commands
Sets the bits in the Standard Event Status Enable Register. A 1 enables the corresponding bit in the Standard Event Status Register; a zero disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask_argument | integer | 0 - 255 | Mask value written to the Standard Event Status Enable Register. |
Returns the contents of the Standard Event Status Register as an integer in NR1 format. Reading the register clears it.
Queries the instrument identification string, including instrument type and software version.
Returns the current instrument state as a valid command that can be used to restore the setup later. The result is a binary block in IEEE 488.2 # format prefixed with ":SYST:SET ".
Sets the operation complete bit in the Standard Event Status Register when all pending device operations have finished. The query version places an ASCII "1" in the output queue when all pending device operations have completed and the interface hangs until it returns.
*OPC *OPC?
Queries the installed options in the instrument. It returns a string identifying the module and its software revision level.
Restores the state of the instrument from the specified save/recall register.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 9 | Save/recall register number to restore. |
Places the instrument in a known factory-default state. It is the same as pressing [Save/Recall] > Default/Erase > Factory Default on the front panel, and differs from :SYSTem:PRESet, which preserves some user settings.
myScope.WriteString "*RST" ' Reset the oscilloscope to the defaults.
Stores the current state of the instrument in a save register. The value parameter specifies the register where the data will be saved.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 9 | Specifies the save register. |
Sets the bits in the Service Request Enable Register. A one in the register enables the corresponding bit in the Status Byte Register; a zero disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | 0 - 255 | Sum of all bits that are set in the Service Request Enable Register. |
*SRE <mask>
Returns the current value of the instrument's status byte. The MSS bit is reported on bit 6 instead of the RQS bit.
Triggers acquisition. The command has the same effect as the :DIGitize command with no parameters.
Performs a self-test on the instrument and places the result in the output queue. A zero indicates the test passed; a non-zero value indicates the test failed.
Waits until all commands sent prior to *WAI have been executed. In this oscilloscope, the command has no function but is parsed for compatibility with other instruments.
Clears the cumulative edge variables for the next activity query.
Reads the Arm Event Register and clears it after the read. A value of 1 indicates the trigger system is armed and ready to accept a trigger.
Evaluates all input signals and sets the correct conditions to display the signals, equivalent to pressing the front-panel Auto Scale key. If sources are specified, those sources are enabled and all others blanked before autoscale is performed.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Input source to autoscale; may be repeated up to five times. |
myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key.
Specifies the acquisition mode that is set by subsequent :AUToscale commands. NORMal sets NORMal acquisition type and RTIMe mode; CURRent keeps the current acquisition type and mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | NORMal | CURRent | Acquisition mode to be set by subsequent autoscale operations. |
Specifies which channels will be displayed on subsequent autoscale operations. When ALL is selected, all channels that meet the autoscale requirements will be displayed; when DISPlayed is selected, only channels that are turned on are autoscaled.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ALL | DISPlayed | Selects which channels are included in subsequent autoscale operations. |
Turns fast debug autoscaling on or off. The fast debug option changes :AUToscale behavior to help quickly distinguish DC voltage, ground, or an active AC signal while maintaining channel coupling.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables fast debug autoscaling. |
Turns off the specified displayed source, such as a channel, math function, digital pod, or serial decode bus. With no parameter, it turns off all sources.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | SBUS1 | WMEMory<r> | Source to blank. |
Specialized RUN command that causes the instrument to acquire waveforms according to the :ACQuire settings and then stop when acquisition is complete. If no source is given, it acquires the currently displayed channels, or all channels if none are displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | SBUS1 | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | Acquisition source to digitize; may be repeated up to five times. |
myScope.WriteString ":DIGitize CHANnel1"
Sets the mask in the Mask Test Event Enable register. Setting specific bits enables corresponding Mask Test events and can trigger bit 9 in the Operation Status Condition Register, potentially causing an SRQ.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 16-bit mask value to load into the Mask Test Event Enable register. |
Returns the integer value contained in the Mask Test Event Register and clears the register.
Sets the mask in the Operation Status Enable register. Setting any of the defined bits to 1 enables bit 7 in the Status Byte Register and may generate an SRQ.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 15-bit integer mask written to the Operation Status Enable register. |
Returns the integer value contained in the Operation Status Condition Register.
Returns the integer value contained in the Operation Status Event Register.
Sets the Overload Event Enable Register mask and enables reporting of overload events. The command uses a 16-bit integer mask to enable fault and overload events for the analog input channels.
| Name | Type | Values | Description |
|---|---|---|---|
| enable_mask | integer | - | 16-bit integer mask representing the overload enable settings. |
:OVLenable <enable_mask> :OVLenable?
Returns the overload protection value stored in the Overload Event Register (OVLR). A value of 1 indicates an overload has occurred.
Formats the output according to the currently selected format (device). If an option is not specified, the value selected in the Print Config menu is used.
| Name | Type | Values | Description |
|---|---|---|---|
| optionsopt | enum | COLor | GRAYscale | PRINter0 | PRINter1 | BMP8bit | BMP | PNG | NOFactors | FACTors | One or more print options, repeated up to 5 times. |
Pulls image data back over the bus for storage. It is an obsolete command provided for compatibility to previous oscilloscopes; use :DISPlay:DATA instead.
| Name | Type | Values | Description |
|---|---|---|---|
| optionsopt | enum | COLor | GRAYscale | BMP8bit | BMP | Print option(s) to apply to the query. |
Returns the oscilloscope run state.
Starts repetitive acquisitions, equivalent to pressing the Run key on the front panel.
myScope.WriteString ":RUN" ' Start data acquisition.
Returns the serial number of the instrument.
Causes the instrument to acquire a single trigger of data. This is the same as pressing the Single key on the front panel.
Reports whether the specified source is displayed. MATH is an alias for FUNCtion.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | SBUS1 | WMEMory<r> | Displayed source to query on DSO models. |
Stops the acquisition. This is the same as pressing the Stop key on the front panel.
Reads the Trigger Event Register. After the register is read, it is cleared; 1 indicates a trigger has occurred and 0 indicates it has not.
Turns on the specified channel, function, or serial decode bus. For MSO models, the source may also be a digital channel, pod, or bus; MATH is an alias for FUNCtion.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | SBUS1 | WMEMory<r> | Specifies which source to display. |
:VIEW CHANnel1
Sets the minimum completion criteria for an acquisition. The only legal value is 100, meaning all time buckets must contain data before the acquisition is considered complete.
| Name | Type | Values | Description |
|---|---|---|---|
| complete | integer | 100 - 100 | Completion criteria percentage for the acquisition. |
myScope.WriteString ":ACQuire:COMPlete 100"
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.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 65536 | Number of values to be averaged for each time bucket. |
Sets the oscilloscope acquisition mode. Use RTIMe for real time mode or SEGMented for segmented memory mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | RTIMe | SEGMented | Acquisition mode to set. |
Returns the number of data points that the hardware will acquire from the input signal. The number of points acquired is not directly controllable; use :WAVeform:POINts to set the number of points transferred from the oscilloscope.
Calculates measurement statistics and/or infinite persistence over all acquired segments. The oscilloscope must be stopped and in segmented acquisition mode, with either quick measurements or infinite persistence on.
Sets the number of memory segments to acquire. Segmented memory acquisition must be enabled with :ACQuire:MODE, and the command is available only when the segmented memory license (SGM) is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 250 | Number of memory segments to acquire, in NR1 format. |
Sets the index into the acquired memory segments. The command is available when the segmented memory license (SGM) is enabled and segmented acquisition mode is in use.
| Name | Type | Values | Description |
|---|---|---|---|
| index | integer | 1 - 250 | Memory segment index to select, in NR1 format. |
:ACQuire:SEGMented:INDex <index> myScope.WriteString ":ACQuire:SEGMented:INDex " + CStr(lngI)
Returns the current oscilloscope acquisition sample rate. The sample rate is not directly controllable.
Selects the acquisition type for the oscilloscope. Available types are normal, average, high-resolution (smoothing), and peak detect.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NORMal | AVERage | HRESolution | PEAK | Selects the acquisition mode to use. |
:ACQuire:TYPE NORMal
Includes or excludes a selected digital bit as part of the definition for the selected bus. This command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Selects whether the specified bit is included in or excluded from the bus definition. |
myScope.WriteString ":BUS1:BIT1 ON"
Includes or excludes selected digital channels in the definition of the specified bus. The command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| channel_list | channel_list | - | List of digital channels or channel ranges to include or exclude, written as (@<m>,<m>:<m>, ...). |
| display | enum | 1 | ON | 0 | OFF | Specifies whether the listed bits are included in the bus definition (1/ON) or excluded (0/OFF). |
myScope.WriteString ":BUS1:BITS (@1,2,4:7), ON" myScope.WriteString ":BUS1:BITS (@1,5,7), ON" myScope.WriteString ":BUS1:BITS (@1:7), ON" myScope.WriteString ":BUS1:BITS (@1:3,5,7), ON"
Excludes all of the digital channels from the selected bus definition. The bus number suffix <n> must be 1 or 2, and the command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Bus number suffix attached to BUS that defines the affected bus. |
Enables or disables the view of the selected bus. This command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Selects whether the bus display is enabled or disabled. |
Sets the label for the specified bus to a quoted string, and adds that name to the label list. The query returns the current bus name.
| Name | Type | Values | Description |
|---|---|---|---|
| quoted_string | string | - | Quoted ASCII label string, 10 characters or less. |
myScope.WriteString ":BUS1:LABel 'Data'"
Sets the mask for the specified bus. The mask determines which bits are included or excluded in the selected bus; a bit value of 1 includes the bit and 0 excludes it. This command is only valid for the MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 32-bit mask value in decimal, nondecimal, or string form. |
:BUS<n>:MASK <mask> :BUS<n>:MASK?
Returns the date of the last calibration.
Saves a calibration label string in the instrument's non-volatile memory. The label may be used to record calibration dates or other information.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string to store as the calibration label, up to 32 characters excluding the quotes. |
Sets the signal available on the rear-panel TRIG OUT BNC. The query returns the current source of the TRIG OUT BNC signal.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | TRIGgers | MASK | WAVEgen | Selects the TRIG OUT BNC source signal. |
Returns the rear-panel calibration protect button state. "PROTected" indicates calibration is disabled, and "UNPRotected" indicates calibration is enabled.
Starts the user calibration procedure.
Returns the summary results of the last user calibration procedure.
Returns the change in temperature since the last user calibration procedure.
Returns the time of the last calibration.
Sets the channel bandwidth limit value and turns on bandwidth limiting. On query, returns the current low-pass filter setting, or the oscilloscope's maximum possible bandwidth when MAXimum is used.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Channel number. |
| limit | real | 25E6 - 25E6 | Bandwidth limit value; the oscilloscope accepts any requested value but uses 25 MHz. |
Controls an internal low-pass filter for the specified channel. When the filter is on, the channel bandwidth is limited to approximately 25 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| bwlimit | enum | 1 | ON | 0 | OFF | Turns the channel bandwidth limit filter on or off. |
Selects the input coupling for the specified analog channel. Each channel can be set to AC or DC.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | AC | DC | Input coupling for the specified channel. |
| nopt | integer | 1 - (# analog channels) | Analog channel number in NR1 format. |
Turns the display of the specified channel on or off. The query returns the current display setting for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| display value | enum | 1 | ON | 0 | OFF | Turns the specified channel display on or off. |
Selects the input impedance setting for the specified analog channel. The only legal value is ONEMeg (1 Ma9).
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | Input impedance setting for the specified analog channel. |
Selects whether to invert the input signal for the specified channel. Inversion may be enabled or disabled for channel n.
| Name | Type | Values | Description |
|---|---|---|---|
| invert value | enum | 1 | ON | 0 | OFF | Sets the channel inversion state. |
Sets the analog channel label to the quoted ASCII string that follows. Labels are limited to 10 characters; longer labels are truncated and lowercase characters are converted to upper case.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII label to assign to the channel. |
myScope.WriteString ":CHANnel1:LABel ""CAL 1""" ' Label ch1 "CAL 1". myScope.WriteString ":CHANnel2:LABel ""CAL2""" ' Label ch1 "CAL2".
Sets the vertical offset value represented at screen center for the selected channel. Values outside the legal range are automatically adjusted to the nearest legal value, and the legal range depends on :CHANnel<n>:RANGe, :CHANnel<n>:SCALe, and probe attenuation.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Vertical offset value in NR3 format. |
| suffixopt | enum | V | mV | Unit suffix for the offset value. |
Sets the probe attenuation factor for the selected channel. The factor may be 0.001 to 10000 and also supports the obsolete values X1, X10, X20, and X100.
| Name | Type | Values | Description |
|---|---|---|---|
| attenuation | real | 0.001 - 10000 | Probe attenuation ratio in NR3 format. |
myScope.WriteString ":CHANnel1:PROBe 10" ' Set Probe to 10:1.
Sets the analog channel probe head type and dB value for the selected channel. Valid only for 113xA Series probes.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 4 | Channel number. |
| head_param | enum | SEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | NONE | Probe head type and dB value. |
Returns the type of probe attached to the specified oscilloscope channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Specifies the oscilloscope channel number in NR1 format. |
Sets the channel-to-channel probe skew factor for the specified analog channel. The skew can be adjusted from -100 ns to +100 ns to remove cable-delay errors between channels.
| Name | Type | Values | Description |
|---|---|---|---|
| skew value | real | -100 ns - +100 ns | Skew time in NR3 format. |
| n | integer | 1 - (# analog channels) | Selects the analog channel number. |
Sets the channel probe signal type to differential or single-ended for 113xA Series probes, which determines how offset is applied. The query returns the current probe signal type for the selected channel.
| Name | Type | Values | Description |
|---|---|---|---|
| signal type | enum | DIFFerential | SINGle | Selects the probe signal type. |
Sets or clears analog channel overvoltage protection for channel <n>. On 2000 X-Series oscilloscopes this command does nothing because the channel input impedance is always 1 M, and the query always returns NORM.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Analog channel number in NR1 format. |
| clearopt | enum | CLEar | Clears protection settings. |
Defines the full-scale vertical axis of the selected channel. When using 1:1 probe attenuation, legal values are from 8 mV to 40 V; the range value is multiplied by the probe attenuation factor if probe attenuation is changed.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | 8 mV - 40 V | Vertical full-scale range value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix appended to the range value. |
":CHANnel1:RANGe 8"
Sets the vertical scale, or units per division, of the selected channel. If the probe attenuation is changed, the scale value is multiplied by the probe's attenuation factor.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | - | Vertical units per division in NR3 format. |
| suffixopt | enum | V | mV | Optional 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.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units for the channel probe. |
Specifies whether the channel's vernier (fine vertical adjustment) setting is ON or OFF. The query returns the current state of the channel's vernier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| vernier value | enum | 1 | ON | 0 | OFF | Turns the channel vernier setting on or off. |
Selects the input impedance setting for the specified channel. This obsolete command is provided for compatibility with previous oscilloscopes; for the 2000 X-Series, the only legal value is ONEMeg (1 M).
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Channel number in NR1 format. |
| impedance | enum | ONEMeg | Input impedance setting. |
Controls the probe sense mode for the specified channel, but this obsolete compatibility command cannot actually change the setting. If the sent mode matches the oscilloscope's current setting, the command is accepted; otherwise a setting conflict error is generated.
| Name | Type | Values | Description |
|---|---|---|---|
| pmode value | enum | AUTo | MANual | Probe sense mode value to send. |
Selects the type of demo signal output by the instrument. The available signal types include sine, noise, burst, digital, serial, and other demo patterns.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | SINusoid | NOISy | PHASe | LFSine | AM | RFBurst | FMBurst | HARMonics | COUPling | RINGing | SINGle | CLK | RUNT | TRANsition | SHOLd | MSO | BURSt | GLITch | ETE | I2C | UART | SPI | CAN | LIN | Selects the demo signal type. |
Sets the phase shift for the second sine waveform used in the phase shifted sine demo signals. The query returns the currently set phase shift.
| Name | Type | Values | Description |
|---|---|---|---|
| angle | real | 0 - 360 | Phase shift angle for the second sine waveform, expressed in degrees and formatted as NR3. |
Specifies whether the demo signal output is ON (1) or OFF (0). The query returns the current state of the demo signal output setting.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Sets the demo signal output state. |
Turns the digital display on or off for the specified channel. This command is only valid for the MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Specifies the digital channel number in NR1 format. |
| display | enum | 1 | ON | 0 | OFF | Sets the digital display state. |
Sets the label of the specified digital channel to a quoted ASCII string of 10 characters or less. The query returns the current channel label.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel index in NR1 format. |
| string | string | 10 characters | Label text as a quoted ASCII string of up to 10 characters. |
Sets the position of the specified digital channel. The query returns the current position; "-1" indicates there is no space to display the digital waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel number to affect. |
| position | integer | - | Display position for the selected channel. |
Sets the display size of digital channels. The size is set for all digital channels, and the command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel index. |
| value | enum | SMALl | MEDium | LARGe | Display size for the digital channels. |
Sets the logic threshold value for all channels in the same pod as the specified digital channel. The threshold is used for triggering purposes and for displaying the digital data as high or low.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel index in NR1 format. |
| value | enum | CMOS | ECL | TTL | Threshold setting or a user-defined threshold value with optional suffix. |
Turns the display annotation on and off. When on, the annotation appears in the upper left corner of the oscilloscope display and can be used for documentation notes before capturing screens.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 1 | ON | 0 | OFF | Enables or disables annotation. |
Specifies the background mode for annotation display. The query returns the specified annotation background mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OPAQue | INVerted | TRANsparent | Sets the annotation background mode. |
Specifies the annotation color. You can choose white, red, or colors that match analog channels, digital channels, math waveforms, reference waveforms, or markers.
| Name | Type | Values | Description |
|---|---|---|---|
| color | enum | CH1 | CH2 | CH3 | CH4 | DIG | MATH | REF | MARKer | WHITe | RED | Annotation color to set. |
Specifies the annotation string displayed on the oscilloscope screen. The string may be up to 254 quoted ASCII characters, and "\n" can be included to represent a carriage return; use an empty string to clear the annotation text.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII annotation text, up to 254 characters. |
:DISPlay:ANNotation:TEXT <string> :DISPlay:ANNotation:TEXT?
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.
Reads screen image data from the display. The image can be returned in BMP, BMP8bit, or PNG format, with optional color or grayscale palette selection.
| Name | Type | Values | Description |
|---|---|---|---|
| formatopt | enum | BMP | BMP8bit | PNG | Selects the image format returned by the query. |
| paletteopt | enum | COLor | GRAYscale | Selects color or grayscale output. |
:DISPlay:DATA? BMP, COLOR myScope.WriteString ":DISPlay:DATA? BMP, COLOR"
Sets the waveform intensity, the same as adjusting the front panel Intensity knob.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 100 | Waveform intensity setting in NR1 format. |
Turns the analog and digital channel labels on and off. The query returns the display mode of the analog and digital labels.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Turns labels on or off. |
myScope.WriteString ":DISPlay:LABel ON" ' Turn on labels.
Adds labels to the label list in alphabetical order. Labels are treated as duplicates if they begin with the same alphabetic base string followed by decimal digits, and duplicate labels are not added.
| Name | Type | Values | Description |
|---|---|---|---|
| binary block data | block | - | An ordered list of up to 75 labels, with a maximum of 10 characters each, separated by newline characters. |
Sets the display persistence setting. You can select zero persistence, infinite persistence, or a variable persistence time in seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MINimum | INFinite | Persistence setting to apply. |
| time | real | 100E-3 - 60E0 | Persistence 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.
Turns display vectors on or off. When enabled, lines are drawn between acquired data points on the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| vectors | enum | 1 | ON | Specifies whether display vectors are enabled. |
Turns display vectors on or off. When vectors are on, the oscilloscope displays lines connecting sampled data points; when off, only the sampled data is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| connect | enum | 1 | ON | 0 | OFF | Selects whether vectors are displayed. |
Returns a list of digital channel numbers in screen order, from top to bottom, separated by commas. Busing is displayed as digital channels with no separator; NONE indicates a channel is turned off.
:DISPLAY:ORDER? myScope.WriteString ":DISPLAY:ORDER 0,10"
Turns the digital voltmeter's Auto Range capability on or off for the selected DVM source channel, if that channel is not used in oscilloscope triggering. When on, the DVM channel's scale, position, and trigger level are automatically adjusted; when off, they can be adjusted normally.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Enables or disables Auto Range. |
Returns the displayed 3-digit DVM value based on the current mode. After DVM analysis is enabled, it may temporarily return +9.9E+37 until good results are available.
Turns the digital voltmeter (DVM) analysis feature on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Turns the DVM analysis feature on or off. |
Returns the displayed 5-digit frequency value shown below the main DVM value.
Sets the digital voltmeter (DVM) mode. The query returns the selected DVM mode.
| Name | Type | Values | Description |
|---|---|---|---|
| dvm_mode | enum | ACRMs | DC | DCRMs | FREQuency | Digital voltmeter mode to select. |
Sets the selected analog channel on which DVM measurements are made. The selected channel does not have to be displayed for DVM measurements to be made.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the DVM input source channel. |
Sets the external trigger bandwidth limit. The command is provided for product compatibility; the only legal value is 0 or OFF. Use :TRIGger:HFReject to limit bandwidth on the external trigger input.
| Name | Type | Values | Description |
|---|---|---|---|
| bwlimit | enum | 0 | OFF | Bandwidth limit setting. |
Specifies the probe attenuation factor for the external trigger. It does not change the actual input sensitivity of the oscilloscope, only the reference constants used for display scaling and trigger levels.
| Name | Type | Values | Description |
|---|---|---|---|
| attenuation | real | 0.001 - 10000 | Probe attenuation ratio in NR3 format. |
Sets the full-scale range for the external trigger. The command is provided for product compatibility; with 1:1 probe attenuation, the range can only be set to 8.0 V and is multiplied by the probe attenuation factor if probe attenuation changes.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | V | Vertical full-scale range value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix for the range value. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units for the external trigger probe. |
Obsolete compatibility command for controlling probe sense mode. If the sent mode matches the oscilloscope setting, the command is accepted; otherwise a setting conflict error is generated.
| Name | Type | Values | Description |
|---|---|---|---|
| pmode value | enum | AUTo | MANual | Selects the probe sense mode. |
Selects the clock signal source for the Chart Logic Bus State operation. The query returns the currently selected clock source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | DIGital<d> | Clock signal source. |
Specifies the clock signal edge for the Chart Logic Bus State operation. The query returns the current clock edge setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | Clock signal edge to use for the Chart Logic Bus State operation. |
Specifies the value associated with each increment in Chart Logic Bus data.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Value per bus code, in NR3 format. |
Specifies the value associated with Chart Logic Bus data equal to zero. The query returns the value associated with data equal to zero.
| Name | Type | Values | Description |
|---|---|---|---|
| value | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | NONE | Vertical units for Chart Logic Bus operations. |
Turns the function display on or off. When ON is selected, the function performs as specified using the other FUNCtion commands; when OFF is selected, the function is neither calculated nor displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Selects whether the function display is enabled or disabled. |
Sets the FFT center frequency when FFT is selected. The valid range is 0 Hz to 25 GHz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 0 - 25 GHz | Current center frequency in NR3 format. |
Sets the frequency span of the display when FFT is selected. The query returns the current frequency span in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| span | real | 1 Hz - 100 GHz | Current frequency span in NR3 format. |
Specifies FFT vertical units. The query returns the current FFT vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | DECibel | VRMS | Selects the FFT vertical units. |
Selects the FFT windowing transform used for the function. The available windows are RECTangular, HANNing, FLATtop, and BHARris (Blackman-Harris).
| Name | Type | Values | Description |
|---|---|---|---|
| window | enum | RECTangular | HANNing | FLATtop | BHARris | Selects the FFT window type. |
Sets the high-pass filter's -3 dB cutoff frequency. The high-pass filter is a single-pole high pass filter.
| Name | Type | Values | Description |
|---|---|---|---|
| 3dB_freq | numeric | - | -3dB cutoff frequency value in NR3 format |
Sets the low-pass filter's -3 dB cutoff frequency. The low-pass filter is a 4th order Bessel-Thompson filter.
| Name | Type | Values | Description |
|---|---|---|---|
| 3dB_freq | real | - | -3dB cutoff frequency value in NR3 format |
Sets the math operation for the g(t) source used as input to transform or filter functions. The query returns the current g(t) source operation setting.
| Name | Type | Values | Description |
|---|---|---|---|
| operation | enum | ADD | SUBTract | MULTiply | Math operation to apply to the g(t) source. |
Selects the first input channel for the g(t) source used as the input to transform or filter functions, if available.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | First input channel for the g(t) source. |
Selects the second input channel for the g(t) source used as the input to transform or filter functions, if available.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel1 | CHANnel2 | CHANnel3 | CHANnel4 | Selects the second input channel. |
Sets the DC offset correction factor for the integrate math waveform input signal. This correction can be used to level a ramped waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| input_offset | real | - | DC offset correction in NR3 format. |
Specifies the 'A' value in the Ax + B operation. The query returns the current gain value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | 'A' in Ax + B, value in NR3 format. |
Specifies the B value in the Ax + B operation.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | B value in the Ax + B operation, formatted as NR3. |
Sets the voltage or vertical value represented at center screen for the selected function. The value is automatically clamped to the nearest legal value if it is outside the allowed range.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | The value at center screen in NR3 format. |
Sets the desired waveform math operation for the selected function. The operation can be one of the listed math, filter, trend, or bus chart modes.
| Name | Type | Values | Description |
|---|---|---|---|
| operation | enum | ADD | SUBTract | MULTiply | INTegrate | DIFF | FFT | SQRT | MAGNify | ABSolute | SQUare | LN | LOG | EXP | TEN | LOWPass | HIGHpass | DIVide | LINear | TRENd | BTIMing | BSTate | Desired waveform math operation. |
Defines the full-scale vertical axis for the selected function. The query returns the current full-scale range value for the selected function.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | - | Full-scale vertical axis value in NR3 format. |
Sets the reference level for the selected function, i.e. the voltage or vertical value represented at center screen. Values outside the legal range are clipped to the nearest legal value; this command is equivalent to :FUNCtion:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | Current reference level in NR3 format. |
Sets the vertical scale, or units per division, of the selected function. Legal values depend on the selected function.
| Name | Type | Values | Description |
|---|---|---|---|
| scale value | integer | - | Scale value in NR1 format. |
| suffixopt | enum | V | dB | Optional unit suffix for the scale value. |
Selects the first source for function operations. It is used for operator math functions and as the single source for transform, filter, and visualization functions.
| Name | Type | Values | Description |
|---|---|---|---|
| source1 | enum | CHANnel<n> | GOFT | BUS<m> | First source for the function operation. |
Specifies the second source for math operator functions that have two sources. The setting is not used for transform, filter, or visualization functions except in the measurement trend visualization case when the measurement requires two sources.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | NONE | Second source selection for the math function. |
Selects the measurement whose trend is shown in the math waveform. The query returns the selected measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | VAVerage | ACRMs | VRATio | PERiod | FREQuency | PWIDth | NWIDth | DUTYcycle | RISetime | FALLtime | Measurement to display as the trend. |
Selects the source for function operations when FFT, DIFF, or INT is selected. This obsolete command is provided for compatibility with previous oscilloscopes; use :FUNCtion:SOURce1 instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | ADD | SUBTract | MULTiply | Source for function operations. |
Turns the selected function on or off. ON enables the function to be calculated and displayed; OFF disables calculation and display.
| Name | Type | Values | Description |
|---|---|---|---|
| view | enum | 1 | ON | 0 | OFF | Selects whether the function is viewed. |
Controls what part of the display area is printed. The only legal choice is SCReen.
| Name | Type | Values | Description |
|---|---|---|---|
| area | enum | SCReen | Selects the display area to print. |
Sets the active printer. The query returns the name of the active printer.
| Name | Type | Values | Description |
|---|---|---|---|
| active_printer | numeric | - | Active printer specified as either the printer list index or the printer name. |
Controls whether the scale factors are output on the hardcopy dump.
| Name | Type | Values | Description |
|---|---|---|---|
| factors | enum | OFF | 0 | ON | 1 | Turns hardcopy scale factors off or on. |
Controls whether a formfeed is output between the screen image and factors of a hardcopy dump. The query returns a flag indicating whether a formfeed is output at the end of the hardcopy dump.
| Name | Type | Values | Description |
|---|---|---|---|
| ffeed | enum | OFF | 0 | ON | 1 | Selects whether formfeed output is disabled or enabled. |
Controls whether the graticule colors are inverted or not.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted. |
Sets the hardcopy layout mode. The query returns the selected hardcopy layout mode.
| Name | Type | Values | Description |
|---|---|---|---|
| layout | enum | LANDscape | PORTrait | Hardcopy layout mode. |
Sets the address for a network printer slot. The address is the server/computer name and printer share name in \\server\share format; use :HARDcopy:NETWork:APPLy to apply the entered address.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | Quoted ASCII string containing the network printer address. |
Applies the network printer settings and makes the printer connection.
Sets the Windows network domain name. The domain name setting is a common setting for both network printer slots.
| Name | Type | Values | Description |
|---|---|---|---|
| domain | string | - | Windows network domain name as a quoted ASCII string. |
Sets the password for the specified Windows network domain and user name. The password setting is a common setting for both network printer slots.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| slot | enum | NET0 | NET1 | Network printer slot to select. |
Sets the user name used when connecting to the Windows network domain. The setting is common to both network printer slots.
| Name | Type | Values | Description |
|---|---|---|---|
| username | string | - | Quoted ASCII string user name to set. |
Sets the hardcopy palette color. The COLor option is not available when connected to laser printers.
| Name | Type | Values | Description |
|---|---|---|---|
| palette | enum | COLor | GRAYscale | NONE | Hardcopy palette color to use. |
Returns a list of available printers. The list can be empty.
Starts a print job.
Sets the hardcopy destination. This is an obsolete command provided for compatibility with previous oscilloscopes; use :HARDcopy:FILename instead.
| Name | Type | Values | Description |
|---|---|---|---|
| destination | enum | CENTronics | FLOPpy | Selects the hardcopy destination. |
Sets the output filename for print formats whose output is a file. This command is obsolete and provided for compatibility with previous oscilloscopes.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string specifying the filename. |
:HARDcopy:FILename <string> :HARDcopy:FILename?
Controls whether grayscaling is performed in the hardcopy dump. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:PALette instead.
| Name | Type | Values | Description |
|---|---|---|---|
| gray | enum | OFF | 0 | ON | 1 | Selects whether grayscale is disabled or enabled. |
Controls whether the graticule colors are inverted. This is an obsolete compatibility command; the manual recommends using :HARDcopy:INKSaver instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted or not. |
Sets the hardcopy printer driver used for the selected printer. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:APRinter instead.
| Name | Type | Values | Description |
|---|---|---|---|
| driver | enum | AP2Xxx | AP21xx | AP2560 | AP25 | DJ350 | DJ35 | DJ6xx | DJ630 | DJ63 | DJ6Special | DJ6Photo | DJ8Special | DJ8xx | DJ9Vip | OJPRokx50 | DJ9xx | GVIP | DJ55xx | PS470 | PS47 | PS100 | PS10 | CLASer | MLASer | LJFastraster | POSTscript | Printer driver to use for the selected printer. |
Returns the lister data.
Configures which serial buses are displayed in the Lister, or turns the Lister display off. Setting "ON" or "1" is equivalent to "SBUS1"; setting "ALL" interleaves decode information from different buses in time.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | SBUS1 | ON | 1 | ALL | Selects the Lister display mode or bus display selection. |
Selects whether the time value for a Lister row is relative to the trigger or the previous Lister row. The query returns the current Lister time reference setting.
| Name | Type | Values | Description |
|---|---|---|---|
| time_ref | enum | TRIGger | PREVious | Selects the time reference for a Lister row. |
Sets the cursors mode. OFF removes cursor information from the display; MANual enables manual X and Y cursor placement; MEASurement tracks the most recent measurement; WAVeform makes the Y cursors track waveform values at the X cursors.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | MEASurement | MANual | WAVeform | Selects the cursor mode. |
Sets the X1 cursor position to the specified value and forces :MARKer:MODE to MANual if it is not currently WAVeform. The X cursor units are set by :MARKer:XUNits.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | X1 cursor position in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Hz | kHz | MHz | Optional unit suffix for the cursor position. |
Sets the source for the cursors. If marker mode is not currently WAVeform, sending the command puts the cursors in MANual mode and setting one marker pair source sets the other pair as well; in WAVeform mode, X1Y1 and X2Y2 sources can be set separately.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Source for the cursors. |
Sets the X2 cursor position to the specified value and sets :MARKer:MODE to MANual if it is not currently WAVeform. The query returns the current X2 cursor position.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | X2 cursor position in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Hz | kHz | MHz | Optional suffix for the X2 cursor position. |
Sets the source for the cursors. The specified channel must be enabled for cursors to be displayed; otherwise an error is issued. If marker mode is not WAVeform, sending this command puts the cursors in MANual mode and also sets the other marker pair’s source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Source for the cursors. |
Returns the value difference between the current X1 and X2 cursor positions. The X-axis cursor units are set by :MARKer:XUNits; if front-panel cursors are off, the marker position values are not defined.
Sets the X cursor units. Available units are seconds, hertz, degrees, or percent; changing X units affects the X1Position, X2Position, and XDELta commands/queries.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | SEConds | HERTz | DEGRees | PERCent | X cursor units to use for measurements. |
Sets the current X1 location as 0 degrees and the current X2 location as 360 degrees when :MARKer:XUNits is DEGRees, or as 0 percent and 100 percent when :MARKer:XUNits is PERCent. Inputs to and outputs from :MARKer:X1Position, :MARKer:X2Position, and :MARKer:XDELta are then relative to those set locations.
Sets the Y1 cursor position when marker mode is not WAVeform; if needed, it first changes :MARKer:MODE to MANual. The query returns the current Y1 cursor position.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | Y1 cursor position in NR3 format. |
| suffixopt | enum | mV | V | dB | Optional suffix for the position value. |
Sets the Y2 cursor position in NR3 format, with an optional unit suffix of mV, V, or dB. If :MARKer:MODE is not currently WAVeform, the command sets :MARKer:MODE to MANual and updates the Y2 cursor position; Y positions cannot be set while in WAVeform mode.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | Y2 cursor position in NR3 format. |
| suffixopt | enum | mV | V | dB | Optional unit suffix for the position. |
Returns the value difference between the current Y1 and Y2 cursor positions. The result is Ydelta = (Value at Y2 cursor) - (Value at Y1 cursor).
Sets the Y cursor units. BASE uses the units associated with the cursor source, and PERCent uses ratio measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | BASE | PERCent | Selects the Y cursor units. |
When PERCent is selected for :MARKer:YUNits, this command sets the current Y1 location as 0 percent and the current Y2 location as 100 percent. After the 0 and 100 percent locations are set, inputs to and outputs from :MARKer:Y1Position, :MARKer:Y2Position, and :MARKer:YDELta are relative to those set locations.
Installs a Snapshot All measurement on the screen.
Installs a screen measurement and starts the bit rate measurement. If an optional source is specified, the currently specified source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Clears all selected measurements and markers from the screen.
Sets up the definition used by measurement queries by specifying delay edge specifications or threshold values. Changing these values can affect results of other measurement commands; for DELay, the definition only affects the :MEASure:DELay? query.
| Name | Type | Values | Description |
|---|---|---|---|
| meas_spec | enum | DELay | THResholds | Selects whether the command defines delay edges or threshold settings. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the waveform source for the measurement definition. |
Places the instrument in continuous measurement mode and starts a delay measurement. The query measures and returns the delay between two sources using the edges and thresholds defined by :MEASure:DEFine.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | First measurement source. |
| source2opt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Second measurement source. |
Installs a screen measurement and starts a duty cycle measurement on the current :MEASure:SOURce. If an optional source is specified, it becomes the current source. The signal must be displayed, and the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | - | - | Measurement source to use. |
Installs a screen measurement and starts a fall-time measurement. If an optional source is specified, the current source is modified; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a screen frequency measurement and starts a frequency measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use for the frequency measurement. |
Installs a screen measurement and starts a negative duty cycle measurement on the current :MEASure:SOURce. If an optional source is specified, it becomes the current source. The signal must be displayed, and the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Measurement source to use. |
Installs a falling edge count measurement on screen. If the optional source is not specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a falling pulse count measurement on screen. If the optional source parameter is not specified, the current source is measured.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source. |
Installs a screen measurement and starts a negative pulse width measurement. If the optional source is not specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | <digital channels> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a screen measurement and starts an overshoot measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the measurement source. |
:MEASure:OVERshoot [<source>] :MEASure:OVERshoot? [<source>]
Installs a rising edge count measurement on screen. If no source is specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a screen measurement and starts a period measurement. If an optional source is specified, the current source is modified. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use for the period measurement. |
Places the instrument in continuous measurement mode and starts a phase measurement. The query measures and returns the phase between the specified sources, calculated from the delay and period measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | First source for the phase measurement. |
| source2opt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Second source for the phase measurement. |
Installs a rising pulse count measurement on screen. If the optional source is not specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a screen measurement and starts a preshoot measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the source waveform for the preshoot measurement. |
Installs a screen measurement and starts the positive pulse width measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source; DIGital<d> is used for MSO models. |
Returns the results of the continuously displayed measurements. The response is a comma-separated list of measurement results, and if no quick measurements are installed it returns an empty string.
:MEASure:RESults?
Installs a screen rise-time measurement and starts measuring rise time. If an optional source is specified, the current source is modified. The query measures and outputs the rise time of the displayed rising edge closest to the trigger reference.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Enables markers for tracking measurements on the display. This feature is always on.
| Name | Type | Values | Description |
|---|---|---|---|
| show | enum | 1 | ON | Turns measurement tracking markers on. |
Sets the default sources for measurements. The specified sources are used by MEASure subsystem commands unless overridden, and the current source changes whenever a source is specified for a measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| source1 | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Primary measurement source. |
| source2opt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Secondary measurement source. |
:MEASure:SOURce CHANnel1
Queries the time interval between the trigger event and a specified transition occurrence on the displayed signal. The sign of the slope selects a rising or falling edge; if the optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | | + | Direction of the waveform: space or plus sign (+) for rising slope, minus sign (-) for falling edge. |
| occurrence | integer | - | The transition number to be reported, counted from the left screen edge. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Optional source to measure from; can be a digital channel, analog channel, function, math, or waveform memory source. |
:MEASURE:TEDGE? +1, CHAN1 :MEASURE:TEDGE? +2, CHAN1
Searches the displayed signal for the specified value level and transition, then returns the time interval between the trigger event and that crossing. If an optional source is specified, the current source is modified; the query is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The vertical value that the waveform must cross. |
| slopeopt | integer | - | Direction of the waveform crossing; plus sign (+) for rising and minus sign (-) for falling. |
| occurrence | integer | - | The transition number to be reported; 1 returns the first crossing, 2 the second, and so on. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to search. |
Installs a screen measurement and starts a vertical amplitude measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a screen measurement and starts an average value measurement. An optional source can be specified to modify the current source, and an optional interval selects either an integral number of cycles or the full screen; if omitted, DISPlay is implied.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Specifies the measurement interval. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Specifies the measurement source. |
Installs a screen measurement and starts a waveform base value measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the measurement source. |
Installs a screen measurement and starts a maximum vertical value measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the waveform source to measure. |
:MEASure:VMAX [<source>] :MEASure:VMAX? [<source>]
Installs a screen measurement and starts a minimum vertical value measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the waveform source for the measurement. |
Installs a screen measurement and starts a vertical peak-to-peak measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a screen measurement and starts an RMS value measurement. Optional interval, type, and source arguments can modify the measurement; if omitted, DISPlay and DC are implied respectively.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval, either an integral number of cycles or the full screen. |
| typeopt | enum | AC | DC | Selects AC RMS or DC RMS measurement mode. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use or modify. |
Returns the value at a specified time on the selected source. The specified time must be on the screen and is referenced to the trigger event; if an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| vtime_argument | real | s | Time from trigger in seconds. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Source on which to measure; optional. |
Installs a screen measurement and starts a waveform top value measurement. The query returns the vertical value at the top of the waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | Measurement source. |
Specifies the measurement window used when the zoomed time base is displayed. The setting can be MAIN, ZOOM, or AUTO; the query returns the current measurement window setting.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | MAIN | ZOOM | AUTO | Selects the measurement window to use. |
Installs a screen measurement and starts an X-at-Max-Y measurement on the selected window. If an optional source is specified, it modifies the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the measurement source. |
Installs a screen measurement and starts an X-at-Min-Y measurement on the selected window. If an optional source is specified, the current source is modified. This command is an alias for :MEASure:TMIN.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Source for the measurement; if specified, it also modifies the current source. |
Sets the lower measurement threshold value. The value and the upper threshold are interpreted as absolute values when thresholds are absolute, and as percentages when thresholds are percent as defined by :MEASure:DEFine THResholds. The command is obsolete and provided for backward compatibility.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | Lower threshold value. |
Clears all selected measurements and markers from the screen. This command is obsolete and provided for backward compatibility; use :MEASure:CLEar instead.
Returns the time difference between the Tstop marker (X2 cursor) and the Tstart marker (X1 cursor). This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:XDELta instead.
Selects the thresholds used when making time measurements. This command is obsolete and provided for backward compatibility; the manual recommends :MEASure:DEFine THResholds instead.
| Name | Type | Values | Description |
|---|---|---|---|
| thresholds | enum | T1090 | T2080 | VOLTage | Threshold set to use for time measurements. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | Selects the waveform source for the measurement. |
Installs a screen measurement and starts an X-at-Min-Y measurement on the selected waveform. If an optional source is specified, it becomes the current source. This command is obsolete and provided for backward compatibility; use :MEASure:XMIN instead.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | Selects the waveform source to measure; if omitted, the current source is used. |
Moves the start marker (X1 cursor) to the specified time with respect to the trigger time. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:X1Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | s | Time at the start marker in seconds. |
| suffixopt | enum | s | ms | us | ns | ps | Unit suffix for the time value. |
Moves the stop marker (X2 cursor) to the specified time with respect to the trigger time. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:X2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | s | Time at the stop marker in seconds. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Queries the time interval between the trigger event and a specified voltage crossing occurrence. It is obsolete and provided for backward compatibility; use :MEASure:TVALue instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The voltage level that the waveform must cross. |
| slopeopt | integer | - | Direction of the waveform; positive sign for rising edge, negative sign for falling edge. |
| occurrence | integer | - | The transition number to be reported. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | Selects the measurement source. |
Sets the upper measurement threshold value. This command is obsolete and provided for backward compatibility; use :MEASure:DEFine THResholds instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The upper measurement threshold value. |
Returns the voltage difference between vertical marker 1 (Y1 cursor) and vertical marker 2 (Y2 cursor). No measurement is made when the query is received; the returned delta is the current value.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| vstart_argument | real | V | Value for vertical marker 1. |
Moves the vertical marker 2 (Y2 cursor) to the specified value for the selected source. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:Y2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| vstop_argument | real | - | Value for the Y2 cursor. |
:MEASure:VSTOp?
Specifies which channel(s) are included in the mask test. ON includes all displayed analog channels; OFF includes only the selected source channel.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Selects whether all displayed analog channels or only the selected source channel are included in the mask test. |
Automatically constructs a mask around the currently selected channel using the tolerance parameters defined by :MTESt:AMASk:XDELta, :MTESt:AMASk:YDELta, and :MTESt:AMASk:UNITs. The mask encompasses only the portion of the waveform visible on the display.
Selects the source used to interpret the :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta parameters when :MTESt:AMASk:UNITs is set to CURRent. This command is the same as :MTESt:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Source channel to use for mask delta interpretation. |
:MTESt:AMASk:SOURce <source> :MTESt:AMASk:SOURce?
Sets how the mask test subsystem interprets automask tolerance parameters. The setting can be based on the current channel units or on screen divisions.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | CURRent | DIVisions | Selects whether automask tolerance parameters use channel units or graticule divisions. |
Sets the X-direction tolerance used by the automasking feature. The absolute tolerance is added to and subtracted from waveform horizontal values to determine the mask boundaries, and the value is interpreted according to :MTESt:AMASk:UNITs.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| channel<n>opt | integer | 1 - (# analog channels) | Channel number to query. |
Resets the mask statistics.
Returns the elapsed time in the current mask test run.
Returns the total number of waveforms acquired in the current mask test run.
Loads a mask from binary block data. The query returns a mask in IEEE 488.2 definite-length binary block format.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | block | - | Binary block data in IEEE 488.2 # format. |
Clears the currently loaded mask.
Enables or disables the mask test features.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Selects whether mask test features are enabled or disabled. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask lock on or off. |
Sets the mask test termination condition. The available conditions are Forever, Sigma, Time, or Waveforms.
| Name | Type | Values | Description |
|---|---|---|---|
| rmode | enum | FORever | SIGMa | TIME | WAVeforms | Termination condition for the mask test. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables measuring only mask failures. |
Sets printing on mask failures on or off. Setting :MTESt:RMODe:FACTion:PRINt ON automatically sets :MTESt:RMODe:FACTion:SAVE OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask failure printing on or off. |
Sets saving on mask failures on or off. Setting ON automatically sets :MTESt:RMODe:FACTion:PRINt OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask failure saving on or off. |
Sets stopping on a mask failure on or off. When ON and a mask violation is detected, the mask test and acquisition system are stopped.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables stopping on mask failure. |
Sets the test sigma level used when :MTESt:RMODe is set to SIGMa. The setting indirectly specifies the number of waveforms that must be tested to reach the sigma level.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.1 - 9.3 | Sigma level to use for the mask test, in NR3 format. |
Sets the number of seconds for a mask test to run when :MTESt:RMODe is set to TIME. The query returns the number of seconds currently set.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 1 - 86400 | Number of seconds for the mask test to run in NR3 format. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 2,000,000,000 | Number of waveforms in NR1 format. |
Enables or disables Bind 1 & 0 Levels control, or Bind -1 & 0 Levels for inverted masks. When enabled, the paired level controls track each other; when disabled, adjusting one changes the mask height.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns Bind control on or off. |
Defines where X=0 in the base coordinate system used for mask testing. The X1 value is a time value specifying the location of the X1 coordinate, which is treated as X=0 for mask region coordinates.
| Name | Type | Values | Description |
|---|---|---|---|
| x1_value | real | - | X1 value in NR3 format. |
Defines the position of the X2 marker with respect to the X1 marker in the mask test coordinate system. The X-coordinate of polygon vertices is normalized using X = (X * ΔX) + X1.
| Name | Type | Values | Description |
|---|---|---|---|
| xdelta_value | real | - | X delta value in NR3 format; a time value specifying the distance of the X2 marker with respect to the X1 marker. |
Defines where Y=0 in the mask-testing coordinate system by setting the Y1 boundary. The query returns the current Y1 marker setting.
| Name | Type | Values | Description |
|---|---|---|---|
| y1_value | real | V | Y1 value in NR3 format. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| y2_value | real | V | Y2 value in NR3 format. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Channel to select. |
Queries the mask title. The returned title is displayed in the mask test dialog box and mask test tab when a mask file is loaded.
Enables or disables averaging for the oscilloscope. When ON, the scope acquires multiple data values for each time bucket and averages them; when OFF, averaging is disabled. This command is obsolete and provided for backward compatibility.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables averaging. |
Sets the number of averages for waveforms when the acquisition type is AVERage. This command is obsolete and provided for backward compatibility.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 65536 | Number of averages to use. |
Loads the specified mask file. The command is obsolete and provided for backward compatibility; use :RECall:MASK[:STARt] instead.
| Name | Type | Values | Description |
|---|---|---|---|
| filename | string | - | MS-DOS compatible name of the file, up to 254 characters long including the path name if used. |
Determines the termination conditions for the mask test. It can run forever, for a specified time in seconds, or until a specified number of waveforms have been acquired.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FORever | TIME | WAVeforms | Termination condition for the mask test. |
| seconds | real | 1 - 86400 | Amount of time in seconds before the mask test terminates. |
| wfm_count | integer | 1 - 1,000,000,000 | Maximum number of waveforms required before the mask test terminates. |
Enables or disables the Stop On Failure run-until criteria for mask testing. When enabled, a mask test stops and the acquisition system stops if a mask violation is detected. This command is obsolete and provided for backward compatibility; the manual recommends :MTESt:RMODe:FACTion:STOP instead.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables Stop On Failure. |
Sets the channel to use as the trigger. This command is obsolete and provided for backward compatibility to previous oscilloscopes.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Trigger source channel, specified as CHANnel<n> where n is 1 to the number of analog channels in NR1 format. |
Turns displaying of the specified group of channels on or off. This command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Turns display on or off for the specified POD group. |
Specifies the size of digital channels on the display for the selected POD group. This command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | SMALl | MEDium | LARGe | Sets the digital channel size. |
Sets the threshold for the specified group of channels. The threshold is used for triggering purposes and for displaying digital data as high or low.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | CMOS | ECL | TTL | Preset threshold type or a user-defined threshold value. |
| user defined value | real | -8.00 - +8.00 | User-defined threshold value in NR3 format. |
| suffixopt | enum | V | mV | uV | Unit suffix for a user-defined threshold value. |
:POD1:THRESHOLD CMOS
Specifies the source for RECall operations by setting the file's base name. The name is a quoted ASCII string and includes no path information or extension.
| Name | Type | Values | Description |
|---|---|---|---|
| base_name | string | - | Quoted ASCII string used as the file's base name. |
Recalls a mask. If a file name is provided, its extension must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | - | - | File specification for the mask to recall; may be an internal location or a quoted file name. |
Sets the present working directory for recall operations. The query form returns the currently set working directory for recall operations.
| Name | Type | Values | Description |
|---|---|---|---|
| path_name | string | - | Quoted ASCII string specifying the recall working directory. |
Recalls an oscilloscope setup. If a file extension is provided as part of a specified file name, it must be ".scp".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | Internal location or quoted ASCII file name to recall from. |
Recalls a reference waveform from a specified file. If a file extension is provided in <file_name>, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string naming the file to recall. |
Specifies the source for SAVE operations by setting the current SAVE filename. The file base name is used without path information or an extension.
| Name | Type | Values | Description |
|---|---|---|---|
| base_name | string | - | Quoted ASCII string that sets the file's base name. |
Saves an image to a file. Set :SAVE:IMAGe:FORMat before using it; if the file extension conflicts with the selected format, the format may be changed to match a valid image extension.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII file name for the saved image. |
Controls whether oscilloscope factors are output along with the image. Factors are written to a separate file with the same path and base name but the ".txt" extension.
| Name | Type | Values | Description |
|---|---|---|---|
| factors | enum | OFF | 0 | ON | 1 | Enables or disables output of oscilloscope factors with the image. |
Sets the image format type. The query returns the selected image format type; when NONE is returned, it indicates that a waveform data file format is currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BMP | BMP24bit | BMP8bit | PNG | Image format type to set. |
Controls whether the graticule colors are inverted or not.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted. |
Sets the image palette color. The query returns the selected image palette color.
| Name | Type | Values | Description |
|---|---|---|---|
| palette | enum | COLor | GRAYscale | Image palette color to set. |
Saves the Lister display data to a file. If a file extension is provided as part of <file_name>, it must be ".csv".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII file name to save the display data to. |
Saves a mask. If a file extension is provided as part of the specified file name, it must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification for the saved mask, either an internal location or a quoted ASCII file name. |
Saves multi-channel waveform data to a file that can be opened by the D9010BSEO Infiniium Offline oscilloscope analysis software. If a file extension is provided, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII file name to save the waveform data to. |
Sets the present working directory for save operations. The query returns the currently set working directory for save operations.
| Name | Type | Values | Description |
|---|---|---|---|
| path_name | string | - | Quoted ASCII string specifying the working directory for save operations. |
Saves an oscilloscope setup. If a <file_name> is provided, any file extension must be ".scp".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification for the saved setup, either an internal location or a quoted ASCII file name. |
Saves oscilloscope waveform data to a file. Set :SAVE:WAVeform:FORMat before saving; if a provided file extension does not match the expected waveform file extension, the format may be changed if the extension is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the file name. |
Sets the waveform data format type used by :SAVE:WAVeform. The query returns the selected waveform data format type.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | ASCiixy | CSV | BINary | Waveform data format to save. |
Sets the waveform data length, that is, the number of points saved, when :SAVE:WAVeform:LENGth:MAX is OFF. When :SAVE:WAVeform:LENGth:MAX is ON, this setting has no effect.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 100 - max. length | Waveform data length to save, in points. |
Specifies whether the maximum number of waveform data points is saved. When OFF, :SAVE:WAVeform:LENGth sets the number of waveform data points saved.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Selects whether maximum waveform length saving is disabled or enabled. |
Specifies which acquired segments are included when a waveform is saved in segmented memory. The query returns the current segmented waveform save option setting.
| Name | Type | Values | Description |
|---|---|---|---|
| option | enum | ALL | CURRent | Selects which segments are saved. |
Selects the source to be saved as a reference waveform file. Only ADD or SUBtract math operations can be saved as reference waveforms; MATH is an alias for FUNCtion.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Source to be saved as a reference waveform file. |
Saves oscilloscope waveform data to a reference waveform file. If a file extension is provided in <file_name>, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Reference waveform file name to save to, given as a quoted ASCII string. |
Returns the selected image area. When saving images it returns SCR (screen); when saving setups or waveform data it returns GRAT (graticule).
Turns displaying of the serial decode bus on or off. This command is only valid when a serial decode option has been licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Display state of the serial decode bus. |
Determines the decode mode for the serial bus. The command is only valid when a serial decode option has been licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CAN | IIC | LIN | SPI | UART | Sets the serial bus decode mode. |
Returns the error frame count.
Returns the overload frame count.
Resets the frame counters.
Returns the total frame count.
Returns the percent utilization of the CAN counter. The return format is a floating-point percent value in NR3 format.
Sets the CAN sample point during the bit time, expressed as a percentage of the bit interval. The query returns the current CAN sample point setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 60 - 87.5 | CAN sample point value in NR3 format. |
Sets the standard CAN signal baud rate. Values from 10 kb/s to 4 Mb/s are accepted in 100 b/s increments, and 5 Mb/s is also allowed; non-divisible values are rounded to the nearest 100 b/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 10000 - 4000000 | Baud rate to set for the CAN signal. |
Sets the CAN signal type when :SBUS<n>:CAN:TRIGger is set to SOF (start of frame). The query returns the current CAN signal type.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | CANH | CANL | RX | TX | DIFFerential | DIFL | DIFH | CAN signal type to use. |
Sets the source for the CAN signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the CAN signal source. |
Sets the CAN trigger condition for the selected serial bus. The query returns the current CAN trigger condition.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | SOF | DATA | ERRor | IDData | IDEither | IDRemote | ALLerrors | OVERload | ACKerror | CAN trigger condition to use. |
Defines the CAN data pattern resource from a string parameter. The string may be binary (0, 1, X, $) or hexadecimal when prefixed with "0x"; excess bits are truncated to the programmed data length.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hexadecimal data pattern string used to define the CAN data pattern resource. |
Sets the number of 8-bit bytes in the CAN data string. The value can be from 1 to 8 bytes, and the bytes themselves are set by :SBUS<n>:CAN:TRIGger:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Number of 8-bit bytes in the CAN data string. |
Defines the CAN identifier pattern resource from a string parameter. If the string starts with "0x", it is interpreted as hexadecimal; otherwise it is interpreted as a binary string with X as don't care, and the pattern is truncated to 29 bits if longer.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CAN identifier pattern string in binary or hexadecimal form. |
Sets the CAN identifier mode for trigger pattern ID matching. Standard selects the 11-bit identifier and Extended selects the 29-bit identifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STANdard | EXTended | CAN identifier mode. |
Determines whether the Read/Write bit is included as the LSB in the display of the IIC address field of the decode bus. The query returns the current IIC address width setting.
| Name | Type | Values | Description |
|---|---|---|---|
| size | enum | BIT7 | BIT8 | Sets the IIC address width display mode. |
Sets the source for the IIC serial clock (SCL). The query returns the current source for the IIC serial clock.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the IIC serial clock. |
Sets the source for IIC serial data (SDA). The query returns the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for IIC serial data (SDA). |
Sets the address for IIC data. The address can be a 7-bit or 10-bit hexadecimal value, or a don't care address to ignore the address value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0x00 - 0x7F | IIC address value. |
Sets the IIC data pattern for trigger qualification. The data value can range from 0x00 to 0x0FF; use -1 or 0xFFFFFFFF for a don't-care data pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | 0x00 - 0x0FF | IIC data pattern value. |
Sets IIC data 2 for the trigger pattern. The data value may be given as an integer or as a hexadecimal string of the form "0xnn"; the don't care value (-1 or 0xFFFFFFFF) ignores the data value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0x00 - 0x0FF | IIC data 2 pattern value. |
Sets the IIC data qualifier when TRIGger:IIC:TRIGger[:TYPE] is set to READEprom. The query returns the current IIC data qualifier value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | LESSthan | GREaterthan | IIC data qualifier to set. |
Sets the IIC trigger type for the selected bus. The value may be one of the listed trigger frame types; the short forms READ and WRIT are also accepted for READ7 and WRITe7, respectively.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STARt | STOP | READ7 | READEprom | WRITe7 | WRITe10 | NACKnowledge | ANACk | R7Data2 | W7Data2 | RESTart | Selects the IIC trigger type. |
Determines whether LIN parity bits are included as the most significant bits in the display of the Frame Id field. The query returns the current LIN parity bits display setting.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Sets whether parity bits are shown as MSB in the Frame Id field display. |
Sets the LIN sample point during the bit time used to determine whether the bit is dominant or recessive. The sample point is expressed as a percentage of bit time and is not limited by the baud rate.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 60 - 87.5 | Sample 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.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 2400 - 625000 | Standard LIN baud rate to set. |
Sets the source for the LIN signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the LIN signal. |
Sets the LIN standard in effect for triggering and decoding to LIN1.3 or LIN2.0. The query returns the current LIN standard setting.
| Name | Type | Values | Description |
|---|---|---|---|
| std | enum | LIN13 | LIN20 | LIN standard to use. |
Sets the LIN sync break length to 11, 12, or 13 clock lengths. The query returns the current LIN sync break setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 11 - 13 | Sets the length of the LIN sync break in clock lengths. |
Sets the LIN trigger condition. The query returns the current LIN trigger value.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | SYNCbreak | ID | DATA | Selects the LIN trigger condition. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 63 | 7-bit identifier value in decimal. |
Sets the LIN trigger data pattern searched for in each LIN data field. The pattern is entered as a string whose format depends on the :SBUS<n>:LIN:TRIGger:PATTern:FORMat base setting, and queried as the currently specified pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | LIN trigger data pattern string. |
Sets the number of 8-bit bytes in the LIN data string. The value can be from 1 to 8 bytes and is set by the :SBUS<n>:LIN:TRIGger:PATTern:DATA command.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Number of 8-bit bytes in the LIN data string. |
Sets the entry number base used by the :SBUS<n>:LIN:TRIGger:PATTern:DATA command. The default base is BINary; the query returns the currently set number base.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | DECimal | Sets the number base used for LIN pattern data. |
Selects the bit order used when displaying data in the serial decode waveform and in the Lister. The query returns the current SPI decode bit order.
| Name | Type | Values | Description |
|---|---|---|---|
| order | enum | LSBFirst | MSBFirst | Bit order to use for SPI decode display. |
Sets the SPI clock source slope used to clock in data. Positive selects the rising edge and negative selects the falling edge.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the rising edge or falling edge of the SPI clock source. |
Sets the SPI signal clock timeout resource in seconds when :SBUS<n>:SPI:FRAMing is set to TIMeout. The timer is used to frame a signal by a clock timeout.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 100 ns - 10 s | Time in seconds in NR3 format. |
Sets the SPI trigger framing value. If TIMeout is selected, the timeout value is set by :SBUS<n>:SPI:CLOCk:TIMeout; NOTC is deprecated and equivalent to NCHipselect.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHIPselect | NCHipselect | NOTC | TIMeout | SPI framing value to select. |
:SBUS<n>:SPI:FRAMing <value> :SBUS<n>:SPI:FRAMing?
Sets the source for the SPI serial clock. The query returns the current source for the SPI serial clock.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the SPI serial clock. |
Sets the frame source when :SBUS<n>:SPI:FRAMing is set to CHIPselect or NOTChipselect. The query returns the current frame source for the SPI serial frame.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the frame source. |
Sets the source for the SPI serial MISO data. The query returns the current source for the SPI serial MISO data.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the SPI serial MISO data. |
Sets the source for the SPI serial MOSI data. The equivalent :SBUS<n>:SPI:SOURce:DATA command can also be used to set the MOSI data source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the source for MOSI data. |
Defines the SPI data pattern resource according to a string parameter. The pattern, together with the data width, controls the data pattern searched for in the data stream.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Pattern string made up of binary digits and don't-care characters, or hexadecimal digits if prefixed with 0x. |
Sets the width of the SPI data pattern. The width must be set before :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | Width of the SPI data pattern in bits. |
Defines the SPI MOSI data pattern resource according to the string parameter. The pattern, together with the data width, controls the data pattern searched for in the data stream; the width should be set before this command.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string of 0, 1, X, and $ characters, or hexadecimal string prefixed with 0x containing hexadecimal digits and X/$ don't-care characters. |
Sets the width of the SPI data pattern. The width can be set from 4 bits to 64 bits and should be set before :SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | SPI data pattern width in bits. |
Specifies whether the SPI trigger is based on MOSI data or MISO data. The query returns the current SPI trigger type setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MOSI | MISO | Selects which SPI data line is used for triggering. |
Determines the number of bits in a word of data for SPI. The query returns the current SPI decode word width.
| Name | Type | Values | Description |
|---|---|---|---|
| word_width | integer | 4 - 16 | Number of bits in a SPI data word. |
Determines the base used for UART decode and Lister display. The query returns the current UART decode and Lister base setting.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | BINary | HEX | Base to use for UART decode and Lister display. |
Selects the bit rate in bps for the serial decoder and/or trigger when in UART mode. The baud rate can be set from 100 b/s to 8 Mb/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 100 - 8000000 | Bit rate to use for UART mode. |
Specifies the bit order used by the physical Tx and Rx input signals for the serial decoder and/or trigger when in UART mode. LSBFirst transmits the least significant bit first; MSBFirst transmits the most significant bit first.
| Name | Type | Values | Description |
|---|---|---|---|
| bitorder | enum | LSBFirst | MSBFirst | Sets the UART bit order. |
Returns the UART error frame count.
Resets the UART frame counters.
Returns the UART Rx frame count.
Returns the UART Tx frame count.
Sets the byte value used for framing (end of packet) for UART decode, or turns framing off. The query returns the current UART decode base setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | Byte value to use for framing, or OFF to disable framing. |
Selects the parity used with each message byte for the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| parity | enum | EVEN | ODD | NONE | Parity setting to use for UART mode. |
Selects the UART polarity as idle low or idle high for the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | HIGH | LOW | Sets the UART polarity. |
Controls which signal is used as the Rx source by the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the UART Rx source signal. |
Controls which signal is used as the Tx source by the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the source used for the UART Tx signal. |
Sets the front panel UART/RS232 trigger setup data selection option. ASCII selects ASCII values; HEX selects hexadecimal values.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Front panel UART/RS232 trigger data selection base. |
Selects the UART trigger burst value, i.e. the Nth frame after an idle period, for UART mode. The valid range is 1 to 4096 or OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | Burst value to use for the trigger. |
Sets the UART trigger data byte value for the selected :SBUS<n> trigger qualifier in UART mode. The value is used when RD or TD trigger types are selected.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | 8-bit trigger data value, entered as decimal, hexadecimal, binary, or quoted string. |
Selects the idle period for burst trigger when in UART mode. The setting is in the range from 1 us to 10 s.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 1 us - 10 s | Time value for the UART trigger idle period, expressed in NR3 format. |
Selects the data qualifier used for the UART trigger when :TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX. The query returns the current UART trigger qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | GREaterthan | LESSthan | Sets the UART trigger data qualifier. |
Selects the UART trigger type. When an RD or TD type is selected, :SBUS<n>:UART:TRIGger:DATA and :SBUS<n>:UART:TRIGger:QUALifier are used to specify the data value and comparison operator.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | RSTArt | RSTOp | RDATa | RD1 | RD0 | RDX | PARityerror | TSTArt | TSTOp | TDATa | TD1 | TD0 | TDX | Selects the UART trigger type. |
Sets the number of bits for each message byte for the serial decoder and/or trigger when in UART mode. The valid width is 5 to 9 bits.
| Name | Type | Values | Description |
|---|---|---|---|
| width | enum | 5 | 6 | 7 | 8 | 9 | UART width setting in bits. |
Returns the number of search events found.
Selects the search mode. The command is only valid when :SEARch:STATe is ON.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | SERial1 | Search mode to select. |
Enables or disables the search feature. The query returns the current setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 0 | OFF | 1 | ON | Enables or disables the search feature. |
Selects the type of CAN information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | DATA | IDData | IDEither | IDRemote | ALLerrors | OVERload | ERRor | Selects the CAN information type to search for in the Lister display. |
Specifies the data value used when searching for Data Frame ID and Data. The data length is set separately with :SEARch:SERial:CAN:PATTern:DATA:LENGth.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hexadecimal data value in the form "0xnn...n", where n is 0-9, A-F, or X. |
Specifies the length of the data value used when searching for Data Frame ID and Data. The data value itself is set with :SEARch:SERial:CAN:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Length of the data value in NR1 format. |
Specifies the CAN pattern ID value used when searching for a CAN event. The value can be a standard ID or an extended ID, depending on :SEARch:SERial:CAN:PATTern:ID:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CAN ID value in hexadecimal format, written as "0xnn...n". |
Specifies whether a standard ID value or an extended ID value is used when searching for a CAN event. The ID value is specified using :SEARch:SERial:CAN:PATTern:ID.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STANdard | EXTended | Selects standard or extended CAN ID matching for the search pattern. |
Selects the type of IIC information to find in the Lister display. The search mode determines whether the instrument looks for 7-bit read/write frames, acknowledge events, restarts, or EEPROM reads.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | READ7 | WRITE7 | NACKnowledge | ANACk | R7Data2 | W7Data2 | RESTart | READEprom | Search mode to select. |
Specifies address values when searching for IIC events. To set don't care values, use the integer -1.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Address value to use for the IIC pattern search; may be an integer or a string in the form "0xnn". |
Specifies data values when searching for IIC events. To set don't care values, use the integer -1; when searching for IIC EEPROM data read events, the data value qualifier is set with :SEARch:SERial:IIC:QUALifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Data value to search for; may be an integer or a string of the form "0xnn". |
Sets the second data value used when searching for IIC events with two data values. Use integer -1 for a don't-care value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | -1 | Second data value for the IIC pattern search. |
Specifies the data value qualifier used when searching for IIC EEPROM data read events.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | LESSthan | GREaterthan | Data value qualifier to use for search matching. |
Specifies the frame ID value when searching for LIN events. The query returns the current frame ID setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 63 | 7-bit frame ID value, accepted as decimal, nondecimal, or string form. |
Selects the type of LIN information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ID | DATA | ERRor | Type of LIN information to search for in the Lister display. |
Specifies the data value used when searching for LIN events. The value format is governed by :SEARch:SERial:LIN:PATTern:FORMat, and HEX format is required to enter don't-care values.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data value string; interpreted as unsigned decimal when FORMAT is DECimal, or as a hexadecimal string when FORMAT is HEX. |
Sets the length of the LIN pattern data value used when searching for LIN events. The value is specified using :SEARch:SERial:LIN:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Length of the data value in NR1 format. |
Specifies the number base used with the :SEARch:SERial:LIN:PATTern:DATA command. The query returns the current number base setting.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | HEX | DECimal | Number base used for the serial line pattern data. |
Specifies whether the SPI search uses MOSI data or MISO data. The query returns the current SPI search mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MOSI | MISO | Selects whether the SPI search is on the MOSI data or the MISO data. |
Specifies the data value used when searching for SPI events. The width of the data value is specified by :SEARch:SERial:SPI:PATTern:WIDTh.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data value in the form "0xnn...n" where n is 0-9, A-F, or X. |
Specifies the width of the SPI data value, in bytes, when searching for SPI events. The data value is set with :SEARch:SERial:SPI:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 1 - 10 | Width of the data value in bytes. |
Sets the data value used when searching for UART/RS232 events. The value qualifier is specified with :SEARch:SERial:UART:QUALifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Data value to search for, entered as an 8-bit integer in decimal, hexadecimal, binary, or quoted string format. |
Selects the type of UART/RS232 information to find in the Lister display. The setting determines whether receive data, transmit data, parity errors, or any error is searched for.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | RDATa | RD1 | RD0 | RDX | TDATa | TD1 | TD0 | TDX | PARityerror | AERRor | Search mode to use for UART/RS232 display searching. |
Specifies the data value qualifier when searching for UART/RS232 events. The query returns the current data value qualifier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | GREaterthan | LESSthan | Data value qualifier to use for UART/RS232 event searches. |
Sets the instrument date. Validity checking is performed to ensure that the date is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| date | string | - | Date value as <year>,<month>,<day>. |
Returns the oscilloscope's Host ID as part of a quoted string. The exact format is product-specific, and portable programs should not attempt to parse the returned contents.
Writes a quoted ASCII string to a text box in the center of the display. Use :SYSTem:DSP "" to remove the message remotely.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string displayed in the center text box, up to 75 characters. |
Outputs the next error number and text from the error queue. Repeated queries return errors in FIFO order until the queue is empty, after which the instrument returns zero until another error occurs.
Disables the front panel. LOCK ON is equivalent to sending a local lockout message over the programming interface.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Sets the front panel lock state. |
Changes the front panel softkey menu.
| Name | Type | Values | Description |
|---|---|---|---|
| menu | enum | MASK | MEASure | SEGMented | LISTer | Selects the front panel softkey menu. |
Places the instrument in a known default state, equivalent to pressing Default Setup on the front panel. Some user settings remain unchanged; use *RST to restore factory defaults for all user settings.
Disables the fifty ohm impedance setting for all analog channels.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Sets the protection lock state. |
Enables or disables remote command logging, optionally specifying the log file name and write mode.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Turns remote command logging off or on. |
| file_nameopt | string | - | Quoted ASCII string used as the log file name. |
| write_modeopt | enum | CREate | APPend | Selects whether to create a new log file or append to an existing one. |
Specifies whether remote commands are logged to a text file, to the screen, or to both. If the destination is changed while remote command logging is running, logging is turned off.
| Name | Type | Values | Description |
|---|---|---|---|
| dest | enum | FILE | SCReen | BOTH | Selects the remote command logging destination. |
Enables or disables the screen display of logged remote commands and, if applicable, their return values. The query reports whether remote command logging display is enabled or disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables the screen display of logged remote commands. |
Specifies the remote command log file name. Because log files are ASCII text files, the ".txt" extension is automatically added to the name specified.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Quoted ASCII string specifying the log file name. |
:SYSTem:RLOGger:FNAMe <file_name> :SYSTem:RLOGger:FNAMe?
Enables or disables remote command logging. The query returns the remote command logging state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables remote command logging. |
Specifies whether the screen display background for remote command logging is transparent or solid.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects transparent or solid background. |
Specifies the remote command logging write mode. The query returns the current remote command logging write mode.
| Name | Type | Values | Description |
|---|---|---|---|
| write_mode | enum | CREate | APPend | Selects the remote command logging write mode. |
Sets the oscilloscope from setup (learn) string data sent from the controller. The setup string is transmitted as an IEEE 488.2 definite-length binary block and does not change the interface mode or interface address.
| Name | Type | Values | Description |
|---|---|---|---|
| setup_data | block | - | Binary block data in IEEE 488.2 # format. |
myScope.WriteIEEEBlock ":SYSTEM:SETUP ", varSetupString
Sets the system time using a 24-hour format. Commas separate hours, minutes, and seconds, and validity checking is performed to ensure the time is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| time | string | - | Hours, minutes, and seconds in NR1 format. |
Sets the current time base mode. The available modes are MAIN, WINDow, XY, and ROLL; MAIN is the default after *RST.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MAIN | WINDow | XY | ROLL | Selects the current time base mode. |
myScope.WriteString ":TIMEBASE:MODE MAIN"
Sets the time interval between the trigger event and the display reference point on the screen. The display reference point is set with :TIMebase:REFerence, and this command is an alias for :TIMebase:DELay.
| Name | Type | Values | Description |
|---|---|---|---|
| pos | real | s | Time in seconds from the trigger to the display reference, in NR3 format. |
Sets the full-scale horizontal time for the main window. The range is 10 times the current time-per-division setting; the query returns the current full-scale range value.
| Name | Type | Values | Description |
|---|---|---|---|
| range_value | real | s | Time for 10 divisions, in seconds, in NR3 format. |
myScope.WriteString ":TIM:RANG 2e-3" ' Set the time range to 0.002 seconds.
Sets the time reference to one division from the left side of the screen, the center of the screen, or one division from the right side of the screen. Time reference is the point on the display where the trigger point is referenced.
| Name | Type | Values | Description |
|---|---|---|---|
| reference | enum | LEFT | CENTer | RIGHt | Time reference position to set. |
myScope.WriteString ":TIMebase:REFerence CENTer" ' Set reference to center.
Sets the horizontal scale, or units per division, for the main window. The query returns the current horizontal scale setting in seconds per division.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_value | real | s | Time per division in seconds, in NR3 format. |
Specifies whether the time base control's vernier (fine horizontal adjustment) setting is ON (1) or OFF (0). The query returns the current vernier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| vernier value | enum | 1 | ON | 0 | OFF | Sets the 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.
| Name | Type | Values | Description |
|---|---|---|---|
| pos value | real | s | Time from the trigger event to the zoomed (delayed) view reference point in NR3 format. |
Sets the full-scale horizontal time for the zoomed (delayed) window in seconds. The main sweep range determines the allowed range; the maximum is one half of :TIMebase:RANGe.
| Name | Type | Values | Description |
|---|---|---|---|
| range value | real | s | Range value in seconds in NR3 format. |
Sets the zoomed (delayed) window horizontal scale in seconds per division. The main sweep scale determines the valid range, and the maximum value is one half of the :TIMebase:SCALe value.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_value | real | s | Scale value in seconds for the zoomed window. |
:TIMebase:WINDow:SCALe <scale_value>
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.
| Name | Type | Values | Description |
|---|---|---|---|
| delay_value | real | s | Time in seconds from trigger to the delay reference point on the screen. |
myScope.WriteString ":TIMEBASE:DELAY 0.0"
Causes an acquisition to be captured even though the trigger condition has not been met. It is equivalent to pressing the front panel Force Trigger key.
Turns the high frequency reject filter off and on. The filter adds a 50 kHz low-pass filter in the trigger path to remove high-frequency noise from the trigger waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 0 | OFF | 1 | ON | Sets the high frequency reject filter mode. |
Defines the trigger holdoff time value in seconds. Holdoff prevents another trigger from occurring until a specified time has passed since the last trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| holdoff_time | real | 40 ns - 10 s | Sets the holdoff time value. |
Automatically sets the trigger levels of all displayed analog channels to their waveforms' 50% values. If AC coupling is used, the trigger levels are set to 0 V; it has no effect when dual trigger levels are used.
Sets the high trigger voltage level for the specified source. High and low trigger levels are used with runt triggers and rise/fall time (transition) triggers.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | High trigger voltage level, specified in NR3 format for internal triggers. |
| source | enum | CHANnel<n> | Trigger source channel. |
Sets the low trigger voltage level for the specified source. High and low trigger levels are used with runt triggers and rise/fall time (transition) triggers.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.75 x full-scale voltage from center screen - 0.75 x full-scale voltage from center screen | Low trigger voltage level in NR3 format for internal triggers. |
| source | enum | CHANnel<n> | Trigger source channel. |
Selects the trigger mode (trigger type). The query returns the current trigger mode; if :TIMebase:MODE is ROLL or XY, it returns "NONE".
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | EDGE | GLITch | PATTern | TV | DELay | EBURst | OR | RUNT | SHOLd | TRANsition | SBUS1 | USB | Trigger mode to select. |
myScope.WriteString ":TRIGger:MODE EDGE"
Turns the trigger noise reject filter off and on. When noise reject is on, the trigger circuitry is less sensitive to noise but may require a larger waveform amplitude to trigger the oscilloscope; the command is not valid in TV trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 0 | OFF | 1 | ON | Sets the noise reject filter mode. |
Selects the trigger sweep mode. AUTO displays a baseline in the absence of a signal, while NORMal stops sweeping when no trigger is present.
| Name | Type | Values | Description |
|---|---|---|---|
| sweep | enum | AUTO | NORMal | Sets the trigger sweep mode. |
Specifies the arming edge slope for the Edge Then Edge trigger delay. The query returns the current arming edge slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Rising or falling edge slope used for arming. |
:TRIGger:DELay:ARM:SLOPe <slope> :TRIGger:DELay:ARM:SLOPe?
Selects the input used for the arming edge in the Edge Then Edge trigger. The query returns the current arming edge source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input source used for the arming edge. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 4 ns - 10 s | Time in seconds in NR3 format. |
Sets the Nth edge of the trigger source to trigger on. The query returns the current Nth trigger edge setting.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Nth trigger edge setting in NR1 integer format. |
Specifies the trigger edge slope for the Edge Then Edge trigger. Positive selects a rising edge; negative selects a falling edge.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Trigger edge slope to use. |
Selects the input used for the trigger edge in the Edge Then Edge trigger. The source may be an analog channel or a digital channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Source channel for the trigger edge. |
Sets the Nth edge at the burst counter resource, which is used in the trigger stage to determine which edge in a burst will generate a trigger. The query returns the current Nth edge burst edge counter setting.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Nth edge burst counter setting in NR1 integer format. |
Sets the Nth edge in a burst idle resource in seconds. The timer sets the minimum time before the next burst.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 10 ns - 10 s | Time in seconds in NR3 format. |
Specifies whether the rising edge (POSitive) or falling edge (NEGative) of the Nth edge in a burst will generate a trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the burst edge polarity used to generate the trigger. |
Selects the input that produces the Nth edge burst trigger. The query returns the current Nth edge burst trigger source, or "NONE" if all channels are off.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input source for the Nth edge burst trigger. |
Sets the input coupling for the selected trigger sources. The coupling can be set to AC, DC, or LFReject; the query returns the current coupling selection.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | AC | DC | LFReject | Input coupling selection for the trigger path. |
Sets the trigger level voltage for the active trigger source. If an optional source is specified and is not the active source, the active source is not changed and its level is not affected.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.75 x full-scale voltage from center screen - ±(external range setting) | Trigger level voltage to set; uses a source-dependent format for internal, external, or digital trigger sources. |
| sourceopt | enum | CHANnel<n> | EXTernal | DIGital<d> | Optional trigger source whose level is being set. |
Turns the low-frequency or high-frequency reject filter on or off. Only one of the two filters can be on at a time, and the reject setting is coupled to :TRIGger[:EDGE]:COUPling.
| Name | Type | Values | Description |
|---|---|---|---|
| reject | enum | OFF | LFReject | HFReject | Selects reject filter state or type. |
Specifies the slope of the edge for the trigger. It is not valid in TV trigger mode; use :TRIGger:TV:POLarity instead.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | ALTernate | Selects the trigger edge slope. |
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"
Selects the input that produces the trigger. Supported sources depend on the model type and include analog channels, digital channels on MSO models, EXTernal, LINE, and WGEN.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | LINE | WGEN | Selects the trigger source for DSO models. |
myScope.WriteString ":TRIGger:EDGE:SOURce CHANnel1"
Sets the minimum pulse width duration for the selected :TRIGger:GLITch:SOURce. The query returns that minimum pulse width duration time.
| Name | Type | Values | Description |
|---|---|---|---|
| greater_than_time | real | - | Minimum pulse width duration time in NR3 floating-point format. |
Sets the maximum pulse width duration for the selected :TRIGger:GLITch:SOURce. The query returns the pulse width duration time for :TRIGger:GLITch:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | s | Maximum pulse width duration. |
Sets the trigger level voltage for the active pulse width trigger. The level depends on trigger source and instrument type; for the query, if all channels are off it returns "NONE."
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | V | Trigger level voltage. |
| sourceopt | enum | CHANnel<n> | EXTernal | DIGital<d> | Trigger source channel or external/digital source. |
Sets the polarity for the glitch pulse width trigger. The query returns the glitch pulse width trigger polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Polarity to set for the glitch pulse width trigger. |
Sets the glitch pulse width trigger qualifier mode. The oscilloscope can trigger on a pulse width that is greater than, less than, or within a range of time values.
| Name | Type | Values | Description |
|---|---|---|---|
| operator | enum | GREaterthan | LESSthan | RANGe | Selects the glitch pulse width qualifier mode. |
:TRIGger:GLITch:QUALifier <operator> :TRIGger:GLITch:QUALifier?
Sets the pulse width duration for the selected :TRIGger:GLITch:SOURce. You can enter the two time parameters in any order; the smaller value becomes <greater_than_time> and the larger value becomes <less_than_time>.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | 15 ns - 10 seconds | Upper pulse-width time limit. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower pulse-width time limit. |
Selects the channel that produces the pulse width trigger. The query returns the current pulse width source; if all channels are off, it returns "NONE".
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | DIGital<d> | CHANnel<n> | Source channel to use for the pulse width trigger. |
Specifies the edges to include in the OR'ed edge trigger. Each bit in the string corresponds to a channel, using R for rising edge, F for falling edge, E for either edge, and X for don't care.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Edge-selection string made up of characters R, F, E, and X, one per channel bit. |
Specifies the channel values to be used in the pattern trigger. The optional edge source and edge parameters must be sent together or not at all, and they take precedence over the ASCII string edge encoding.
| Name | Type | Values | Description |
|---|---|---|---|
| pattern | string | - | Pattern string, optionally followed by edge source and edge when the format is HEX. |
Sets the entry and query number base used by the :TRIGger:PATTern command. The default base is ASCii.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Number base used for pattern trigger patterns. |
Qualifies when the trigger occurs. On InfiniiVision 2000 X-Series oscilloscopes, the trigger always occurs when the pattern is entered.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | ENTered | Trigger duration qualifier. |
Sets the polarity for the runt trigger. The query returns the current runt trigger polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | EITHer | Selects whether runt trigger pulses are positive, negative, or either polarity. |
Selects the qualifier used for specifying runt pulse widths. GREaterthan triggers on runt pulses wider than :TRIGger:RUNT:TIME, LESSthan triggers on runt pulses narrower than :TRIGger:RUNT:TIME, and NONE triggers on runt pulses of any width.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | NONE | Selects the runt pulse width qualifier. |
Selects the channel used to produce the runt trigger. The query returns the current runt trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel used to produce the trigger. |
Sets the runt pulse qualifier time used when triggering on runt pulses whose width is greater than or less than a specified value. The time value is a floating-point NR3 number with an optional time suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Runt pulse qualifier time setting. |
Specifies whether the rising edge or the falling edge of the clock signal is used. The query returns the current rising or falling edge setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the clock edge slope used for triggering. |
Selects the input channel probing the clock signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input channel source for the clock signal. |
Selects the input channel probing the data signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Data signal source channel. |
Sets the hold time. The query returns the currently specified hold time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Hold time value in NR3 floating-point format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Sets the setup time. The query returns the currently specified setup time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Setup time to set, in NR3 floating-point format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time unit suffix. |
Specifies whether the trigger looks for rise/fall times greater than or less than a specified time value. The time value is set with :TRIGger:TRANsition:TIME.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | Selects whether the transition time condition is greater than or less than the specified time value. |
Sets the trigger transition slope to positive rising edge or negative falling edge. The query returns the current rise/fall time trigger slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Specifies the trigger transition slope. |
Selects the channel used to produce the trigger. The query returns the current transition trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | string | - | Channel to use as the trigger source. |
Sets the time value for rise/fall time triggers. Use :TRIGger:TRANsition:QUALifier to specify whether triggering occurs for times greater than or less than this value.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Floating-point time value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time unit suffix. |
Sets the TV trigger to fire on a specific video line. Valid line-number limits vary with the selected TV standard and mode.
| Name | Type | Values | Description |
|---|---|---|---|
| line_number | integer | 1 - 625 | Video line number in NR1 integer format. |
Selects the TV trigger mode and field. Old forms for the mode value are accepted.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FIEld1 | FIEld2 | AFIelds | ALINes | LFIeld1 | LFIeld2 | LALTernate | TV trigger mode and field. |
Sets the polarity for the TV trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | TV trigger polarity to set. |
Selects the channel used to produce the trigger. The query returns the current TV trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Channel to use as the trigger source. |
Selects the TV trigger standard.
| Name | Type | Values | Description |
|---|---|---|---|
| standard | enum | NTSC | PALM | PAL | SECam | Video standard to use for TV triggering. |
Sets the source for the USB D- signal. The allowed source keywords differ between DSO and MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for the USB D- signal. |
Sets the source for the USB D+ signal. The allowable sources depend on the model family: DSO models accept a channel or external source, while MSO models accept a channel or digital source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for the USB D+ signal. |
Sets the expected USB signal speed to Low Speed or Full Speed. The query returns the current USB signal speed value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | LOW | FULL | Expected USB signal speed. |
Sets where the USB trigger will occur. The query returns the current USB trigger value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | SOP | EOP | ENTersuspend | EXITsuspend | RESet | Selects the USB trigger event. |
Sets the trigger threshold for a pod of 8 digital channels. The threshold can be set to a predefined level or to a user-defined voltage; for predefined thresholds, the voltage value is not required.
| Name | Type | Values | Description |
|---|---|---|---|
| channel group | enum | POD1 | POD2 | Selects which pod channel group the threshold applies to. |
| threshold type | enum | CMOS | ECL | TTL | USERdef | Chooses a predefined threshold level or a user-defined threshold. |
| valueopt | real | V | User-defined threshold voltage in volts. |
Selects the TV trigger mode and field. This obsolete command is provided for compatibility with previous oscilloscopes; use :TRIGger:TV:MODE instead.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERtical | Sets the TV trigger mode and field. |
:TRIGger:TV:TVMode <mode> :TRIGger:TV:TVMode?
Sets the output sequence of WORD data. It affects transmitting sequence only when :WAVeform:FORMat WORD is selected, and the default setting is MSBFirst.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | LSBFirst | MSBFirst | Specifies whether the most significant byte or least significant byte is transmitted first. |
Returns the count used to acquire the current waveform. For all acquisition types except average, this value is 1.
Returns the binary block of sampled data points in IEEE 488.2 arbitrary block data format. The data format depends on :WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and :WAVeform:SOURce, and the number of points is controlled by :WAVeform:POINts.
:WAVeform:DATA?
Sets the data transmission mode for waveform data points, controlling how waveform data is formatted when sent from the oscilloscope. For queries, returns the current output format for waveform data transfer.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | WORD | BYTE | ASCii | Selects the waveform data format. |
Sets the number of waveform points transferred with the :WAVeform:DATA? query. The allowed values depend on the waveform points mode, and the <points_mode> option is deprecated in favor of :WAVeform:POINts:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| points | integer | 100 - 1000000 | Number of waveform points to transfer. |
myScope.WriteString ":WAVEFORM:POINTS 1000"
Sets the data record transferred with the :WAVeform:DATA? query. The mode selects the measurement record, raw acquisition record, or whichever record contains the maximum number of points.
| Name | Type | Values | Description |
|---|---|---|---|
| points_mode | enum | NORMal | MAXimum | RAW | Selects which data record is transferred by :WAVeform:DATA?. |
Requests the preamble information for the selected waveform source. The preamble contains the vertical and horizontal scaling information for the corresponding channel and is returned as a preamble block.
:WAVeform:PREamble?
Returns the number of memory segments in the acquired data. It can be queried while segments are being acquired, though :DIGitize blocks subsequent queries until segmented acquisition completes.
Returns the time tag of the currently selected segmented memory index. The selected index is set with :ACQuire:SEGMented:INDex.
Selects the source used by the WAVeform commands. The source can be an analog channel, function, reference waveform, or, on MSO models, a digital pod or bus; FUNCtion and MATH are treated as the same source in the query response.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | SBUS1 | POD{1 | 2} | BUS{1 | 2} | Selects the waveform source. |
myScope.WriteString ":WAVEFORM:SOURCE CHAN1"
Selects the waveform subsource when the waveform source is SBUS<n> serial decode. SUB0 is the default; UART uses SUB1 for TX, and SPI uses SUB1 for MISO.
| Name | Type | Values | Description |
|---|---|---|---|
| subsource | enum | SUB0 | RX | MOSI | SUB1 | TX | MISO | Specifies which serial-decode data set to use. |
Returns the acquisition mode associated with the currently selected waveform. The acquisition mode is set by :ACQuire:TYPE; if :WAVeform:SOURce is POD1 or POD2, the type is always NORM.
Turns unsigned mode on or off for the currently selected waveform. It controls whether data values are sent as unsigned or signed integers and has no effect if the data format is ASCII.
| Name | Type | Values | Description |
|---|---|---|---|
| unsigned | enum | 0 | OFF | 1 | ON | Enables or disables unsigned mode. |
Sets the view setting associated with the currently selected waveform. The only legal value is MAIN.
| Name | Type | Values | Description |
|---|---|---|---|
| view | enum | MAIN | View setting for the currently selected waveform. |
Returns the x-increment value for the currently specified source. This value is the time difference between consecutive data points in seconds.
Returns the x-origin value for the currently specified source. In this product, it is always the X-axis value of the first data point (XREFerence = 0).
Returns the x-reference value for the currently specified source. In this product, the x-reference point is the first point displayed and XREFerence is always 0.
Returns the y-increment value in volts for the currently specified source. This is the voltage difference between consecutive data values; for digital waveforms, the y-increment is always "1".
Returns the y-origin value for the currently specified source. For this product, it is the Y-axis value of the center of the screen.
Returns the y-reference value for the currently specified source. This is the data point value where the y-origin occurs; in this product, it is the data point value at the center of the screen. It is undefined if the format is ASCII.
Sets the waveform generator frequency in Hz. For all waveforms except Noise and DC, the frequency can also be specified indirectly using :WGEN:PERiod.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Waveform generator frequency in Hz, in NR3 format. |
Selects the waveform type for the waveform generator. The query returns the currently selected signal type.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | SINusoid | SQUare | RAMP | PULSe | NOISe | DC | Waveform type to output. |
Specifies the pulse width for Pulse waveforms. The pulse width can be adjusted from 20 ns to the period minus 20 ns.
| Name | Type | Values | Description |
|---|---|---|---|
| width | real | 20 ns - period minus 20 ns | Pulse width in seconds in NR3 format. |
Sets the symmetry of the ramp waveform. Symmetry represents the amount of time per cycle that the ramp waveform is rising.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | Symmetry percentage in NR1 format. |
Sets the square wave duty cycle. Duty cycle is the percentage of the period that the waveform is high.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | integer | 20 - 80 | Duty cycle percentage in NR1 format. |
Specifies the amount of amplitude modulation. The setting is expressed as AM depth percentage from 0% to 100% in NR1 format.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | AM depth percentage. |
Specifies the frequency of the modulating signal. The query returns the frequency of the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency in Hz in NR3 format. |
Sets the FM frequency deviation from the original carrier signal frequency. The deviation is specified in Hz and must satisfy the carrier-frequency limits described in the manual.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Frequency deviation in Hz, in NR3 format. |
Specifies the frequency of the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency in NR3 format. |
Specifies the FSK hop frequency. The output frequency shifts between the original carrier frequency and this hop frequency.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Hop frequency in Hz in NR3 format. |
Sets the FSK modulation rate, which determines how fast the output frequency shifts. The rate is specified in Hz using NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | FSK modulation rate. |
Specifies the shape of the modulating signal. It applies to AM and FM modulation; for RAMP, the ramp symmetry is set with :WGEN:MODulation:FUNCtion:RAMP:SYMMetry.
| Name | Type | Values | Description |
|---|---|---|---|
| shape | enum | SINusoid | SQUare | RAMP | Shape of the modulating signal. |
Sets the ramp waveform symmetry percentage, which controls the amount of time per cycle that the ramp waveform is rising. The query returns the current ramp symmetry percentage setting.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0 - 100 | Symmetry percentage in NR1 format. |
Adds noise to the currently selected waveform generator signal. The allowable percent range varies with the current amplitude because the combined original signal and injected noise are limited by the regular amplitude limit.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0 - 100 | Percent of noise to add to the selected signal. |
Enables or disables modulated waveform generator output. Modulation can be enabled for all waveform generator function types except pulse, DC, and noise.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Specifies whether modulation is enabled or disabled. |
Selects the modulation type for the waveform generator. The available types are AM, FM, and FSK.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | AM | FM | FSK | Modulation type to select. |
Specifies whether the waveform generator signal output is ON (1) or OFF (0). The query returns the current state of the waveform generator output setting.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns the waveform generator output on or off. |
Selects the expected output load impedance used for displayed amplitude and offset calculations. The actual Gen Out BNC output impedance is fixed at 50 ohms.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
Sets the waveform generator period for all waveforms except Noise and DC. The period may also be specified indirectly using :WGEN:FREQuency.
| Name | Type | Values | Description |
|---|---|---|---|
| period | real | s | Period of the waveform in seconds, using NR3 format. |
Restores the waveform generator factory default settings: 1 kHz sine wave, 500 mVpp, 0 V offset.
Sets the waveform amplitude in volts. For all waveforms except DC, use this command to specify amplitude; use :WGEN:VOLTage:OFFSet for offset voltage or DC level.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Amplitude in volts in NR3 format. |
Sets the waveform high-level voltage for all waveforms except DC. The query returns the currently specified waveform high-level voltage.
| Name | Type | Values | Description |
|---|---|---|---|
| high | real | V | High-level voltage in volts, in NR3 format. |
Sets the waveform low-level voltage for all waveforms except DC. Use :WGEN:VOLTage:HIGH to specify the high-level voltage; the high and low levels can also be set indirectly with :WGEN:VOLTage and :WGEN:VOLTage:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| low | real | V | Low-level voltage in volts, in NR3 format. |
Specifies the waveform offset voltage, or DC level. Use :WGEN:VOLTage to specify the amplitude, or :WGEN:VOLTage:HIGH and :WGEN:VOLTage:LOW to set amplitude and offset indirectly.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | V | Offset voltage in NR3 format. |
:WGEN:VOLTage:OFFSet <offset> :WGEN:VOLTage:OFFSet?
Clears the specified reference waveform location.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform location in NR1 format. |
Turns the display of the specified reference waveform on or off. Only one reference waveform can be displayed at a time; enabling one reference waveform automatically turns the other off.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform location in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Turns the specified reference waveform display on or off. |
Sets the reference waveform label to the specified string. Labels are limited to 10 characters; longer labels are truncated and lowercase characters are converted to uppercase.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform number in NR1 format. |
| string | string | - | Quoted ASCII label string. |
Copies the analog channel or math function waveform to the specified reference waveform location. Only ADD or SUBtract math operations can be saved as reference waveforms.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform location in NR1 format. |
| source | enum | CHANnel<n> | FUNCtion | MATH | Waveform source to save. |
Sets the skew factor for the specified reference waveform. The query returns the current skew setting for the selected reference waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform number in NR1 format. |
| skew | real | s | Time skew value in seconds in NR3 format. |
Sets the vertical offset value represented at screen center for the selected reference waveform. The legal range depends on :WMEMory<r>:YRANge or :WMEMory<r>:YSCale, and out-of-range values are adjusted to the nearest legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Vertical offset value in NR3 format. |
| suffixopt | enum | V | mV | Voltage suffix for the offset value. |
Defines the full-scale vertical axis of the selected reference waveform. Legal values are copied from the original source waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform number in NR1 format. |
| range | real | V | Vertical full-scale range value in NR3 format. |
| suffixopt | enum | V | mV | Units suffix appended to the range. |
Sets the vertical scale, or units per division, of the selected reference waveform. Legal scale values are copied from the original source waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | V | Vertical units per division. |
| suffixopt | enum | V | mV | Optional unit suffix for the scale. |
Clears the cumulative edge variables for the next activity query. This is an obsolete command provided for compatibility with previous oscilloscopes; use :ACTivity instead.
Sets the source text to a quoted ASCII string and adds the name to the label list. This obsolete command is provided for compatibility; use :CHANnel<n>:LABel or :DIGital<n>:LABel instead.
| Name | Type | Values | Description |
|---|---|---|---|
| source_text | enum | CHANnel1 | CHANnel2 | DIGital<d> | Selects the analog or digital channel whose label source text is being set. |
| string | string | - | Quoted ASCII string to assign as the label. |
Sets the threshold for a group of channels. The threshold may be one of the predefined types, or a user-defined voltage value; for predefined values, the voltage parameter is ignored.
| Name | Type | Values | Description |
|---|---|---|---|
| channel group | enum | POD1 | POD2 | Channel group to configure. |
| threshold type | enum | CMOS | ECL | TTL | USERdef | Threshold type to apply. |
| valueopt | real | V | Voltage for USERdef threshold type. |
Sets the skew between channels 1 and 2. This obsolete command is provided for compatibility with previous oscilloscopes; the probe skew control can be used to remove cable delay errors.
| Name | Type | Values | Description |
|---|---|---|---|
| skew value | real | -100 ns - +100 ns | Skew time in NR3 format. |
Erases the screen. This is an obsolete compatibility command; use :DISplay:CLEar instead.