Clears the status data structures, the device-defined error queue, and the Request-for-OPC flag. If it immediately follows a program message terminator, the output queue and MAV bit are also cleared.
SCPI COMMAND REFERENCE
The Keysight DSOX1202G is Keysight's oscilloscope in the InfiniiVision 1200 X-Series family. Its SCPI remote-control interface exposes 503 commands across 47 subsystems - 502 settable and 1 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.
503
Commands
502
Settable
1
Queries
47
Subsystems
SCPI
Verified
2026-07-16
All commands
Sets the bits in the Standard Event Status Enable Register. A 1 enables the corresponding bit in the Standard Event Status Register; a 0 disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask_argument | integer | 0 - 255 | Mask value used to enable or disable bits in the Standard Event Status Enable Register. |
Queries the contents of the Standard Event Status Register. Reading the register returns the total bit weights of all bits that are high and clears the register.
Identifies the instrument type and software version.
Returns the current state of the instrument as a valid command string that can be used to restore instrument settings later. The returned string contains ":SYST:SET " before the IEEE 488.2 binary block setup data.
Sets the operation complete bit in the Standard Event Status Register when all pending device operations have finished.
Reports the options installed in the instrument. The query 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 recall. |
Places the instrument in a known factory-default state. This is the same as pressing [Save/Recall] > Default/Erase > Factory Default on the front panel.
myScope.WriteString "*RST" ' Reset the oscilloscope to the defaults.
Stores the current state of the instrument in a save register. The value specifies which register the data will be saved in.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 9 | Save register number. |
Sets the Service Request Enable Register mask. A one in the mask enables the corresponding bit in the Status Byte Register; a zero disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | 0 - 255 | Mask value with bits defined in the SRE table. |
Returns the current value of the instrument's status byte. The MSS bit is reported on bit 6 instead of the RQS bit.
*STB?
Triggers a digitize operation. It 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 failure.
Waits to continue execution of subsequent commands. The oscilloscope does not implement any function for *WAI, but it is parsed for compatibility with other instruments.
Reads the Arm Event Register and then clears it. A value of 1 indicates the trigger system is armed and ready to accept a trigger.
Evaluates input signals and automatically sets display conditions, like pressing the front-panel Auto Scale key. If one or more sources are specified, those channels are enabled and all others blanked before autoscale is performed.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | One or more channels to autoscale; each source is a CHANnel<n> and may be repeated up to 5 times. |
:AUToscale myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key.
Specifies the acquisition mode used by subsequent :AUToscale operations. The query returns the current autoscale acquire mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | NORMal | CURRent | Acquisition mode to set for subsequent autoscale operations. |
Specifies which channels will be displayed on subsequent :AUToscales. All channels that meet the autoscale requirements are displayed when ALL is selected; only channels that are turned on are autoscaled when DISPlayed is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ALL | DISPlayed | Selects which channels are included in subsequent autoscale operations. |
Turns fast debug auto scaling on or off. The Fast Debug option changes the behavior of :AUToscale to make quick visual comparisons for determining whether the probed signal is a DC voltage, ground, or an active AC signal.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns fast debug auto scaling on or off. |
Turns off the specified channel, math function, or serial decode bus. With no parameter, it turns off all sources.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | WMEMory<r> | ABUS | EXT | Source to blank (stop displaying). |
Causes the instrument to acquire waveforms according to the :ACQuire settings and then stop. If no source is given, it acquires the currently displayed channels, or all channels if none are displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | ABUS | EXT | Specifies one or more sources to acquire, repeatable up to 5 times. |
myScope.WriteString ":DIGitize CHANnel1"
Sets the Mask Test Event Enable register with a 16-bit integer mask. Setting selected bits enables corresponding mask test event conditions and may generate an SRQ.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 16-bit integer mask written to the Mask Test Event Enable register. |
Returns the integer value contained in the Mask Test Event Event Register and clears the register.
Sets a 15-bit mask in the Operation Status Enable register. Setting selected bits enables bit 7 in the Status Byte Register and may generate an SRQ.
| 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 enable mask in the Overload Event Enable Register and enables reporting of the Overload Event Register. If enabled, an overload event sets bit 11 in the Operation Status Register.
| Name | Type | Values | Description |
|---|---|---|---|
| enable_mask | integer | - | 16-bit integer mask representing the enabled overload-event inputs. |
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 print device and options. 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, each repeated up to 5 times. |
Pulls image data back over the bus for storage. It is an obsolete compatibility query and is not a core command.
| Name | Type | Values | Description |
|---|---|---|---|
| optionsopt | enum | COLor | GRAYscale | BMP8bit | BMP | Selects the print output format or palette options used for the query. |
Starts repetitive acquisitions. This is the same as 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. The source may be a channel, function, serial decode bus, memory waveform, or EXT source; MATH is an alias for FUNCtion.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | WMEMory<r> | ABUS | EXT | Specifies which source to check for display state. |
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. MATH is an alias for FUNCtion, and EXT is available on 2-channel oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | WMEMory<r> | ABUS | EXT | Specifies which source to display. |
:VIEW CHANnel1
Includes or excludes the selected bit as part of the definition for the selected bus. The suffix <m> specifies the analog channel affected by the command.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Includes (1/ON) or excludes (0/OFF) the selected bit from the bus definition. |
myScope.WriteString ":ABUS:BIT1 ON"
Includes or excludes selected bits in the channel list for the definition of the analog bus. The query returns the current bus bit definition.
| Name | Type | Values | Description |
|---|---|---|---|
| channel_list | channel_list | - | Bit or bit-range list in the form (@<m>,<m>:<m>, ...) where commas separate bits and colons define bit ranges. |
| display | enum | 1 | ON | 0 | OFF | Includes selected bits when set to 1 or ON, and excludes them when set to 0 or OFF. |
myScope.WriteString ":ABUS:BITS (@0,2), ON" myScope.WriteString ":ABUS:BITS (@0:2), ON"
Excludes all of the analog channels from the selected bus definition.
Enables or disables the view of the selected bus. The query returns the display value of the selected bus.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Enables or disables bus display. |
Sets the bus label to a quoted string. Labels are 10 characters or less; longer labels are truncated. The query returns the specified bus name.
| Name | Type | Values | Description |
|---|---|---|---|
| quoted_string | string | - | Quoted ASCII label string, up to 10 characters. |
myScope.WriteString ":ABUS:LABel 'Data'"
Defines the bits included and excluded in the selected bus according to a mask. Set a mask bit to 1 to include that bit in the selected bus, and 0 to exclude it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 32-bit integer mask value, accepted in decimal, nondecimal (#H or #B), or string form. |
Specifies the minimum completion criteria for an acquisition and affects the operation of :DIGitize. The only legal value is 100, meaning all time buckets must contain data before the acquisition is considered complete.
| Name | Type | Values | Description |
|---|---|---|---|
| complete | integer | 100 - 100 | Minimum completion criteria for an 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 set to AVERage, the count can be set from 2 to 65536; the :ACQuire:COUNt 1 command is deprecated.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 65536 | Number of values to average for each time bucket. |
Sets the oscilloscope acquisition mode. RTIMe selects real time mode; SEGMented selects 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 mode is enabled with :ACQuire:MODE, and acquisition is performed using :DIGitize, :SINGle, or :RUN.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 500 | Number of memory segments to acquire. |
Sets the index into the acquired segmented memory segments. The query returns the current segmented memory index setting.
| Name | Type | Values | Description |
|---|---|---|---|
| index | integer | 1 - 500 | Index into the memory segments that have been acquired. |
:ACQuire:SEGMented:INDex 25 :ACQuire:SEGMented:INDex?
Returns the current oscilloscope acquisition sample rate. The sample rate is not directly controllable.
Selects the oscilloscope acquisition type. The query returns the current acquisition type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NORMal | AVERage | HRESolution | PEAK | Acquisition type to use. |
:ACQuire:TYPE NORMal myScope.WriteString ":ACQuire:TYPE NORMal"
Returns the date of the last calibration.
Saves a calibration label string in the instrument's non-volatile memory. The label can be used to record calibration dates or other information.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string up to 32 characters, not including the quotes. |
Sets the signal available on the Gen Out BNC for oscilloscopes with a built-in waveform generator. The query returns the current Gen Out BNC signal selection.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | TRIGgers | MASK | OFF | Selects the Gen Out BNC signal. |
Returns the rear-panel calibration protect (CAL 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 and turns on bandwidth limiting. The oscilloscope accepts any requested limit but uses the only available limit, 25 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | 25E6 - 25E6 | Bandwidth limit value to set. |
Controls an internal low-pass filter for the specified channel. When enabled, the channel bandwidth is limited to approximately 25 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| bwlimit | enum | 1 | ON | 0 | OFF | Turns the bandwidth limit filter on or off. |
| n | integer | 1 - (# analog channels) | Channel number in NR1 format. |
Selects the input coupling for the specified channel. The coupling for each analog channel can be set to AC or DC.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | AC | DC | Input coupling for the specified channel. |
| n | integer | 1 - (# analog channels) | Channel number in NR1 format. |
Turns the display of the specified channel on or off. The query returns the current display setting for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| display value | enum | 1 | ON | 0 | OFF | Sets the channel display state. |
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. The inversion state may be set to ON (inverted) or OFF (not inverted).
| Name | Type | Values | Description |
|---|---|---|---|
| invert value | enum | 1 | ON | 0 | OFF | Sets the channel inversion state. |
Sets the analog channel label to the specified quoted ASCII string. Labels are limited to 10 characters; longer labels are truncated and lowercase letters are converted to uppercase.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII label string to assign to the analog channel. |
myScope.WriteString ":CHANnel1:LABel ""CAL 1""" ' Label ch1 "CAL 1". myScope.WriteString ":CHANnel2:LABel ""CAL2""" ' Label ch1 "CAL2".
Sets the vertical offset value represented at center screen for the selected channel. Legal values depend on :CHANnel<n>:RANGe, :CHANnel<n>:SCALe, and probe attenuation; out-of-range values are adjusted to the nearest legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Vertical offset value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix. |
Sets the probe attenuation factor for the selected channel. The factor may be 0.1 to 10000, and obsolete attenuation values X1, X10, X20, and X100 are also supported.
| Name | Type | Values | Description |
|---|---|---|---|
| attenuation | real | 0.1 - 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. This command is valid only for the 113xA Series probes.
| Name | Type | Values | Description |
|---|---|---|---|
| head_param | enum | SEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | NONE | Analog channel probe head type and dB setting. |
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 |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Analog channel number to configure. |
| skew value | real | -100 ns - +100 ns | Skew time in NR3 format. |
Sets the channel probe signal type to differential or single-ended for 113xA Series probes and affects how offset is applied. The query returns the current probe signal type for the selected channel.
| Name | Type | Values | Description |
|---|---|---|---|
| signal type | enum | DIFFerential | SINGle | Selects the probe signal type. |
Sets or clears the channel protection state for analog channel <n>. On these oscilloscopes the command does nothing because the analog input impedance is always 1 MΩ, and the query always returns NORM.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Analog channel number in NR1 format. |
Defines the full-scale vertical axis of the selected channel. For 1:1 probe attenuation, legal range values are from 8 mV to 40 V, and the entered range is multiplied by the probe attenuation factor if probe attenuation changes.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | 8 mV - 40 V | Vertical full-scale range value in NR3 format. |
| suffixopt | enum | V | mV | Units suffix for the range value. |
:CHANnel1:RANGe 8
Sets the vertical scale, or units per division, of the selected channel. If the probe attenuation is changed, the scale value is multiplied by the probe's attenuation factor.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Selected channel number. |
| scale | real | V | Vertical units per division in NR3 format. |
| suffixopt | enum | V | mV | Unit suffix appended to the scale value. |
Sets the measurement units for the connected probe on the specified channel. Measurement results, channel sensitivity, and trigger level reflect the selected units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units to use for the channel probe. |
Specifies whether the channel's vernier (fine vertical adjustment) setting is on or off. The query returns the current state of the channel's vernier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| vernier value | enum | 1 | ON | 0 | OFF | Sets the channel vernier state. |
Selects the input impedance setting for the specified channel. This command is obsolete and provided for compatibility with previous oscilloscopes; use :CHANnel<n>:IMPedance instead.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Input impedance setting to select. |
Sets or queries the probe sense mode for the specified channel. The setting is obsolete and provided for compatibility; the mode cannot actually be changed, and the query returns whether an autosense probe is attached.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Channel number in NR1 format. |
| pmode value | enum | AUTo | MANual | Probe sense mode value. |
Selects the type of demo signal output on the demo terminal. The query returns the currently selected demo signal type.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | SINusoid | NOISy | LFSine | AM | RFBurst | FMBurst | HARMonics | COUPling | RINGing | SINGle | CLK | TRANsition | BURSt | GLITch | CAN | LIN | Specifies the demo signal function to output. |
Sets whether the demo signal output is ON or OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Specifies the demo signal output state. |
Turns annotation on or off. When on, the annotation appears in the upper left corner of the oscilloscope display and can be used for documentation purposes.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 1 | ON | 0 | OFF | Sets the annotation state. |
Specifies the background mode for annotations. The query returns the currently specified annotation background mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OPAQue | INVerted | TRANsparent | Selects the annotation background style. |
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 use. |
Specifies the annotation text displayed on the oscilloscope screen. The string may be up to 254 characters and can be cleared by sending an empty quoted string.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII annotation string, 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, data for active channels and functions 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 color or grayscale palette selection; default is BMP, COLOR.
| Name | Type | Values | Description |
|---|---|---|---|
| formatopt | enum | BMP | BMP8bit | PNG | Screen image file format to return. |
| paletteopt | enum | COLor | GRAYscale | Color or grayscale palette for the returned screen image. |
: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. |
Turns the analog channel labels on and off. The query returns the display mode of the analog channel labels.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Turns the analog channel labels on or off. |
myScope.WriteString ":DISPlay:LABel ON" ' Turn on labels.
Adds labels to the display label list. Labels are added in alphabetical order, 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 softkey menu timeout period. OFF and MAX are equivalent.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 5 - 60 | Softkey menu timeout period in NR1 format. |
| qualifier | enum | OFF | MAX | Alternative keywords equivalent to a numeric timeout value. |
Sets the display persistence setting. You can choose zero persistence, infinite persistence, or a variable persistence time in seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MINimum | INFinite | Persistence setting to apply. |
Enables or disables transparent mode for DVM, mask test statistics, and waveform memory readouts in the front panel graphical user interface. The query returns the current transparent setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Sets the transparent mode state. |
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 vectors on and off, controlling whether the oscilloscope displays lines connecting sampled data points or only the sampled data. This obsolete command is provided for compatibility with previous oscilloscopes; use :DISPlay:VECTors instead.
| Name | Type | Values | Description |
|---|---|---|---|
| connect | enum | 1 | ON | 0 | OFF | Turns vectors on or off. |
Turns the digital voltmeter's Auto Range capability on or off for the selected DVM source channel when that channel is not used in oscilloscope triggering. When enabled, the channel's vertical scale, vertical position, and trigger level are automatically adjusted; when disabled, the channel can be adjusted normally.
| 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 take a few seconds before the query returns a good value instead of +9.9E+37.
Turns the digital voltmeter (DVM) analysis feature on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Selects whether DVM analysis is disabled or enabled. |
Returns the displayed 5-digit frequency value shown below the main DVM value. If the DVM FREQuency mode requirements are not met, the query returns 9.9E+37.
Sets the digital voltmeter (DVM) mode. The frequency mode requires EDGE or GLITch trigger mode, and the DVM source and trigger source must be the same analog channel.
| Name | Type | Values | Description |
|---|---|---|---|
| dvm_mode | enum | ACRMs | DC | DCRMs | FREQuency | Selects the DVM mode. |
Sets the analog channel on which DVM measurements are made. The selected channel does not have to be displayed for DVM measurements to be made.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Analog channel used as the DVM input source. |
Sets the external trigger bandwidth limit. This command is provided for product compatibility; the only legal value is 0 or OFF. The related :TRIGger:HFReject command is used to limit bandwidth on the external trigger input.
| Name | Type | Values | Description |
|---|---|---|---|
| bwlimit | enum | 0 | OFF | Bandwidth-limit setting for the external trigger input. |
Sets the external trigger input display setting. On InfiniiVision DSOX1204A/G oscilloscopes, the command can be set to OFF only.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | External trigger input display setting. |
Sets the external trigger input's label. Labels are quoted ASCII strings up to 10 characters; longer labels are truncated and lowercase characters are converted to uppercase.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII label string to assign to the external trigger input. |
Sets the external trigger input threshold voltage level. The query returns the current external trigger input threshold voltage setting.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | External trigger input threshold value in NR3 format. |
| suffix | enum | V | mV | Unit suffix for the level value. |
Sets the external trigger input waveform's vertical position on the oscilloscope display. The base of the displayed waveform can be positioned from -3.5 divisions to 2.5 divisions; on InfiniiVision DSOX1204A/G oscilloscopes it can be set to zero only.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | -3.5 - 2.5 | Vertical position of the external trigger input waveform in divisions. |
Specifies the probe attenuation factor for the external trigger. The setting affects trigger scaling references, not the oscilloscope input sensitivity.
| Name | Type | Values | Description |
|---|---|---|---|
| attenuation | real | 0.1 - 10000 | Probe attenuation ratio in NR3 format. |
Sets the external trigger input signal range. For DSOX1200-Series oscilloscopes the range is 1.6 V or 8 V with a 1:1 probe; for EDUX1000-Series oscilloscopes it is 8 V with a 1:1 probe and cannot be changed.
| 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; measurement results, channel sensitivity, and trigger level reflect the selected units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units for the external trigger probe. |
Obsolete compatibility command related to external probe sense mode. The mode is internally controlled and cannot be set; if the sent value matches the oscilloscope setting, the command is accepted, otherwise a setting conflict error is generated.
| Name | Type | Values | Description |
|---|---|---|---|
| pmode value | enum | AUTo | MANual | Probe sense mode value. |
Sets the FFT center frequency when FFT is selected. The query returns the current center frequency in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | -25 GHz - 25 GHz | Current center frequency in NR3 format. |
Turns the FFT function display on or off. When ON, the FFT function is calculated and displayed; when OFF, it is neither calculated nor displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether FFT display is off or on. |
Sets the FFT vertical value represented at center screen. If the specified value is outside the legal range, it is adjusted to the nearest legal value. This command is equivalent to :FFT:REFerence.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | The value at center screen in NR3 format. |
Defines the full-scale vertical axis value for the FFT function.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | - | Full-scale vertical axis value in NR3 format. |
Specifies the FFT vertical value represented at center screen. If the level is set outside the legal range, it is automatically adjusted to the nearest legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | Current reference level in NR3 format. |
Sets the vertical scale, or units per division, of the FFT function. Legal values depend on the selected function.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_value | real | - | Floating-point scale value in NR3 format. |
| suffixopt | enum | dB | Optional suffix for the scale value. |
Selects the source for the FFT function.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | - | - |
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 the FFT vertical units. The query returns the current FFT vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | DECibel | VRMS | FFT vertical units to set. |
Selects the FFT windowing transform used for the FFT function. The default window is HANNing.
| Name | Type | Values | Description |
|---|---|---|---|
| window | enum | RECTangular | HANNing | FLATtop | BHARris | FFT window to apply. |
:FFT:WINDow HANNing
Returns the frequency response analysis data. The data is returned in four comma-separated columns for each step in the sweep: Frequency (Hz), Amplitude (Vpp), Gain (dB), and Phase (°).
Turns the Frequency Response Analysis (FRA) feature on or off. The query returns a flag indicating whether FRA is on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Specifies whether FRA is enabled or disabled. |
Selects the frequency response analysis mode, either swept frequency response analysis or single-frequency analysis. The single mode is available only through the remote programming interface.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | SWEep | SINGle | Sets the frequency mode. |
Sets the single frequency value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 10 Hz - 20 MHz | Single frequency value in NR3 format. |
| suffixopt | enum | Hz | kHz | MHz | Optional unit suffix appended to the value. |
Sets the frequency sweep start value. The query returns the frequency sweep start setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 10 Hz - 19.99 MHz | Frequency sweep start value, specified in NR3 format with an optional Hz, kHz, or MHz suffix. |
Sets the frequency sweep stop value. The query returns the frequency sweep stop setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 10.1 Hz - 20 MHz | Frequency sweep stop value in NR3 format. |
| suffixopt | enum | Hz | kHz | MHz | Optional unit suffix for the frequency value. |
Performs the Frequency Response Analysis by sweeping a sine wave across a frequency range and measuring gain and phase of the DUT. :FRANalysis:APPLy is a valid compatible alias.
Specifies the analog input channel used to probe the input voltage to the DUT in the frequency response analysis. The query returns the currently selected input channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Analog input channel to use for probing the DUT input voltage. |
Specifies the analog input channel that is probing the output voltage from the DUT in the frequency response analysis. The query returns the currently selected channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel selecting the output-voltage probe input. |
Sets the total number of points in the frequency response analysis sweep. The query returns the current number of points setting.
| Name | Type | Values | Description |
|---|---|---|---|
| pts | integer | 1 - 1000 | Number of points in NR1 format. |
Specifies whether to include gain, phase, both, or neither in the frequency response analysis results. It affects the oscilloscope front panel graphical user interface and saved analysis data.
| Name | Type | Values | Description |
|---|---|---|---|
| selection | enum | NONE | ALL | GAIN | PHASe | Selects which analysis data to include in the frequency response analysis results. |
Selects the expected output load impedance used by the waveform generator to display correct amplitude and offset levels. The actual Gen Out BNC output impedance is fixed at 50 ohms.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
Specifies the waveform generator's output sine wave amplitude. Use :WGEN:VOLTage:OFFSet to specify the offset voltage or DC level, or :WGEN:VOLTage:HIGH and :WGEN:VOLTage:LOW to set amplitude and offset indirectly.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Amplitude in volts, in NR3 format. |
Specifies the number of points per decade in the frequency response analysis. This command is deprecated; use :FRANalysis:SWEep:POINts instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 10 - 50 | Number of points per decade. |
Turns function display on or off. When ON, the function is performed using the other FUNCtion commands; when OFF, the function is neither calculated nor displayed.
| 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 query returns the current center frequency in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | 0 Hz - 25 GHz | Current center frequency in NR3 format. |
Sets the reference point for calculating the FFT Phase function to either the trigger point or the beginning of the displayed waveform. The query returns the selected reference point.
| Name | Type | Values | Description |
|---|---|---|---|
| ref_point | enum | TRIGger | DISPlay | Reference point for FFT phase calculation. |
Sets the FFT display frequency span from left graticule to right graticule. The current span can be queried in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| span | real | 1 Hz - 100 GHz | Current frequency span in NR3 format. |
Specifies the FFT vertical units. The allowed units depend on whether the FFT magnitude or FFTPhase operation is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | DECibel | VRMS | DEGRees | RADians | Sets the FFT vertical units. |
Selects the FFT windowing transform used for the :FUNCtion[:FFT] operation. The HANNing window is the default.
| Name | Type | Values | Description |
|---|---|---|---|
| window | enum | RECTangular | HANNing | FLATtop | BHARris | FFT window type to apply. |
Sets the low-pass filter's -3 dB cutoff frequency. The low-pass filter is a 4th order Bessel-Thompson filter.
| Name | Type | Values | Description |
|---|---|---|---|
| 3dB_freq | real | - | -3 dB cutoff frequency value in NR3 format. |
Sets the math operation for the g(t) source used as the input to the FFT function. The available operations are ADD, SUBTract, and MULTiply.
| Name | Type | Values | Description |
|---|---|---|---|
| operation | enum | ADD | SUBTract | MULTiply | Math operation for the g(t) source. |
Selects the first input channel for the g(t) source used as input to the FFT function.
| Name | Type | Values | Description |
|---|---|---|---|
| value | channel_list | 1 - # analog channels | Channel selection in CHANnel<n> form, where n ranges from 1 to the number of analog channels. |
Selects the second input channel for the g(t) source used as the input to the FFT function.
| Name | Type | Values | Description |
|---|---|---|---|
| value | channel_list | - | Channel selection CHANnel<n>, where n is 1 to the number of analog channels in NR1 format. |
Sets the voltage or vertical value represented at center screen for the selected function. Values outside the legal range are automatically set to the nearest legal value; this command is equivalent to :FUNCtion:REFerence.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | The value at center screen in NR3 format. |
Sets the desired waveform math operation for the selected function. Supported operations are ADD, SUBTract, MULTiply, DIVide, FFT, FFTPhase, and LOWPass.
| Name | Type | Values | Description |
|---|---|---|---|
| operation | enum | ADD | SUBTract | MULTiply | DIVide | FFT | FFTPhase | LOWPass | Selects the 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 | - | The full-scale vertical axis value in NR3 format. |
Sets the reference level (voltage or vertical value) represented at center screen for the selected function. The command is equivalent to :FUNCtion:OFFSet; values outside the legal range are rounded to the nearest legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -10 - 10 | 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, including channel math operations and FFT. For FFT, GOFT is only available and specifies a g(t) source used with :FUNCtion:GOFT:OPERation, :FUNCtion:GOFT:SOURce1, and :FUNCtion:GOFT:SOURce2.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | GOFT | Source to use for function operations. |
:FUNCtion:SOURce1 <value> :FUNCtion:SOURce1?
Specifies the second source for math operations that have two sources, such as ADD, SUBTract, or MULTiply. The setting is not used when :FUNCtion:OPERation is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | NONE | Selects the second math source channel or disables the source. |
Selects the source for function operations when an FFT operation is selected. This obsolete command is provided for compatibility with previous oscilloscopes; use :FUNCtion:SOURce1 instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | ADD | SUBTract | MULTiply | Specifies the source for FFT function operations. |
Turns the selected function on or off. When ON, the function is calculated and displayed; when OFF, it is neither calculated nor displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| view | enum | 1 | ON | 0 | OFF | Selects whether the function is viewed (on) or hidden (off). |
Controls what part of the display area is printed. Currently, the only legal choice is SCReen.
| Name | Type | Values | Description |
|---|---|---|---|
| area | enum | SCReen | Specifies 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 | - | Specifies the active printer by index or by name. |
Controls whether the scale factors are output on the hardcopy dump.
| Name | Type | Values | Description |
|---|---|---|---|
| factors | enum | OFF | 0 | ON | 1 | Enables or disables output of the scale factors on the hardcopy dump. |
Controls whether a formfeed is output between the screen image and factors of a hardcopy dump.
| Name | Type | Values | Description |
|---|---|---|---|
| ffeed | enum | OFF | 0 | ON | 1 | Selects whether a formfeed is output. |
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 | Selects the hardcopy layout mode. |
Sets the address for a network printer slot. The address is entered as a quoted ASCII string in an IP-address or print-server path format.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | Quoted ASCII string specifying the printer or print server address. |
Applies the network printer settings and makes the printer connection.
Selects the network printer slot used for the address and apply commands. Two slots are available.
| Name | Type | Values | Description |
|---|---|---|---|
| slot | enum | NET0 | NET1 | Network printer slot to use. |
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 may be empty.
Starts a print job.
Sets the hardcopy destination. This obsolete command is 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 is an obsolete compatibility command; use :SAVE:FILename or :RECall:FILename instead.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string specifying the filename. |
Controls whether grayscaling is performed in the hardcopy dump. This obsolete command is provided for compatibility; use :HARDcopy:PALette instead.
| Name | Type | Values | Description |
|---|---|---|---|
| gray | enum | OFF | 0 | ON | 1 | Enables or disables grayscaling in the hardcopy dump. |
Controls whether the graticule colors are inverted. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:INKSaver instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted. |
Sets the hardcopy printer driver used for the selected printer. This command is obsolete and provided only for compatibility; use :HARDcopy:APRinter instead.
| 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 hardcopy output. |
Returns the lister data.
Turns the serial bus Lister display on or off. Serial bus decode must be on before it can be displayed in the Lister.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | SBUS1 | ON | 1 | Selects whether the Lister display is off or on. |
Selects whether the time value for a Lister row is relative to the trigger or the previous Lister row. The query returns the current Lister time reference setting.
| Name | Type | Values | Description |
|---|---|---|---|
| time_ref | enum | TRIGger | PREVious | Selects the time reference for a Lister row. |
:LISTer:REFerence <time_ref> :LISTer:REFerence?
Sets the cursors mode. OFF removes cursor information from the display; MANual enables manual cursor placement; MEASurement makes cursors track the most recent measurement; WAVeform makes the Y cursors track waveform values at the X cursors.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | MEASurement | MANual | WAVeform | Selects the cursors mode. |
Sets the X1 cursor position to the specified value. It also sets :MARKer:MODE to MANual if the mode is not currently WAVeform; cursor units are set by :MARKer:XUNits.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | X1 cursor position in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Hz | kHz | MHz | Optional suffix for the X1 cursor position. |
Sets the source for the cursors. If the marker mode is not currently WAVeform, sending this command puts the cursors in MANual mode and also sets the source for the other marker pair.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r> | EXTernal | Source for the cursors. |
Sets the X2 cursor position to the specified value and switches :MARKer:MODE to MANual if it is not currently WAVeform. The X cursor units are set by :MARKer:XUNits.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | X2 cursor position in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Hz | kHz | MHz | Optional unit suffix for the X2 cursor position. |
Sets the source for the cursors. If the marker mode is not currently WAVeform, sending this command puts the cursors in MANual mode; if the mode is WAVeform, X2Y2source can be set separately from X1Y1source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Source to use for the cursors. |
Returns the value difference between the current X1 and X2 cursor positions. Xdelta is calculated as the value at X2 minus the value at X1, using the X units set by :MARKer:XUNits.
Sets the X cursors units. Changing X units affects the input and output values of :MARKer:X1Position, :MARKer:X2Position, and :MARKer:XDELta commands/queries.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | SEConds | HERTz | DEGRees | PERCent | Selects the X cursor units. |
Sets the current X1 location as 0 degrees and the current X2 location as 360 degrees when :MARKer:XUNits is set to DEGRees. When :MARKer:XUNits is set to PERCent, it sets X1 to 0 percent and X2 to 100 percent; subsequent X1/X2/Delta positions are relative to these set locations.
Sets or queries the Y1 cursor position. When :MARKer:MODE is not WAVeform, setting this command forces :MARKer:MODE to MANual and updates the Y1 cursor position; the query returns the current Y1 cursor position.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | Y1 cursor position in NR3 format. |
| suffixopt | enum | mV | V | dB | Optional unit suffix for the position. |
Sets the Y2 cursor position in NR3 format and, if marker mode is not WAVeform, forces :MARKer:MODE to MANual. The query returns the current Y2 cursor position.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | Y2 cursor position in NR3 format. |
| suffixopt | enum | mV | V | dB | Units suffix for the cursor position. |
Returns the value difference between the current Y1 and Y2 cursor positions, computed as Y2 minus Y1. The value is returned in the Y cursor units set by :MARKer:YUNits.
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 :MARKer:YUNits is set to PERCent, this command sets the current Y1 location as 0 percent and the current Y2 location as 100 percent. After the percent locations are set, inputs to and outputs from :MARKer:Y1Position, :MARKer:Y2Position, and :MARKer:YDELta are relative to those locations.
Installs a Snapshot All measurement on the screen.
Installs a screen measurement and starts the bit rate measurement. If the optional source parameter is specified, the currently specified source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Measurement source to use. |
Clears all selected measurements and markers from the screen.
Installs a counter measurement and starts counting trigger-level crossings for the selected source. If an optional source is specified, it changes the current source; the source may be any channel except Math or EXTernal.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | EXTernal | Specifies the measurement source. |
Sets up the definition for measurements by specifying delay edge specifications or threshold values. Changing these values may affect the results of other measurement commands.
| Name | Type | Values | Description |
|---|---|---|---|
| meas_spec | enum | DELay | THResholds | Selects whether delay or threshold definitions are being set. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r> | Selects the source used for the measurement definition. |
Places the instrument in continuous measurement mode and starts a delay measurement between two selected sources. The query measures and returns the delay using the user-defined edge and threshold settings from :MEASure:DEFine, while the non-query version runs in auto-edge select mode.
| 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 also changes the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Source signal to measure. |
Installs a screen measurement and starts a fall-time 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. |
Installs a screen measurement and starts a frequency measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Measurement source to use. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Specifies the source signal to measure. |
Installs a falling edge count measurement on screen. If no source is specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source. |
Installs a falling pulse count measurement on screen. If the optional source is not specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a screen measurement and starts a negative pulse width measurement. If the optional source parameter is omitted, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Measurement source to use. |
:MEASure:NWIDth [<source>] :MEASure:NWIDth? [<source>]
Installs a screen overshoot measurement and starts measuring overshoot. If an optional source is specified, the current source is modified. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
Installs a rising edge count measurement on screen. If the optional source 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 period measurement and starts the period measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Selects the measurement source. |
Places the instrument in continuous measurement mode and starts a phase measurement. The query measures and returns the phase between the specified sources, calculated from delay and period.
| 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 rising pulse count measurement on screen. If no source is specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use. |
:MEASure:PPULses? [<source>]
Installs a screen measurement and starts a preshoot measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the measurement source. |
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 | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Measurement source to use. |
Returns the results of the continuously displayed measurements as a comma-separated list of values. If more than one continuous measurement is running, the results are duplicated in left-to-right display order.
:MEASure:RESults?
Installs a screen measurement and starts a rise-time 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 standard deviation measurement; if an optional source is specified, the current source is modified. The query measures and outputs the standard deviation of the selected waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the measurement source waveform. |
Enables markers for tracking measurements on the display. This feature is always on.
| Name | Type | Values | Description |
|---|---|---|---|
| show | enum | 1 | ON | Marker display state. |
Sets the default source selections used by MEASure subsystem commands when sources are not explicitly specified. If a source is specified for any measurement, the current source is changed to that value.
| Name | Type | Values | Description |
|---|---|---|---|
| source1 | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Primary measurement source. |
| source2opt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Secondary measurement source; applies only to delay and phase measurements. |
:MEASure:SOURCE CHANNEL1
Determines the type of information returned by the :MEASure:RESults? query. ON means all statistics are on.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | ON | 1 | CURRent | MINimum | MAXimum | MEAN | STDDev | COUNt | Selects the statistics mode. |
:MEASure:STATistics?
Disables or enables the display of the measurement statistics.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether measurement statistics display is disabled or enabled. |
Updates the statistics once by incrementing the count by one using the current measurement values. It is only allowed when the oscilloscope is stopped and quick measurements are on; segmented acquisition mode is allowed.
Specifies the maximum number of values used when calculating measurement statistics. The query returns the current measurement statistics max count setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | INFinite | Sets the statistics max count to infinite or to a numeric count. |
| countopt | integer | 2 - 2000 | Numeric maximum count in NR1 format. |
Resets the measurement statistics and zeroes the counts. The measurement statistics configuration is not deleted.
Disables or enables relative standard deviations, i.e. standard deviation/mean, in the measurement statistics.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether relative standard deviations are disabled or enabled. |
Queries the time interval between the trigger event and the specified waveform transition. The optional source parameter can be used to modify the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | + | - | Direction of the waveform transition; rising is indicated by space or plus sign, falling by minus sign. |
| occurrence | integer | 1 | Transition number to be reported, counted from the left screen edge. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Selects the signal source to search for the specified transition. |
:MEASURE:TEDGE? +1, CHAN1 :MEASURE:TEDGE? +1, CHAN2 :MEASURE:TEDGE? +2, CHAN1
Queries the time interval from the trigger event to the specified value crossing of the displayed signal. The query searches for the requested level, slope, and occurrence, and returns the crossing time in seconds; if the crossing cannot be found, it returns +9.9E+37.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Vertical value that the waveform must cross. |
| slopeopt | enum | + | - | Direction of the waveform crossing; plus sign for rising edge, minus sign for falling edge. |
| occurrence | integer | - | Transition number to report, where 1 is the first crossing, 2 the second, and so on. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Source signal to measure; if specified, the current source is modified. |
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. |
Installs a screen measurement and starts an average value measurement. If an optional source is specified, the current source is modified; if interval is omitted, DISPlay is implied.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Specifies the measurement interval as an integral number of cycles or the full screen. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r> | Selects the source for the average value measurement. |
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 | FFT | WMEMory<r> | Selects the waveform source to measure. |
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 | FFT | WMEMory<r> | Selects the waveform source used for the minimum vertical value 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 | FFT | WMEMory<r> | Selects the measurement source. |
Installs a screen measurement and starts an RMS value measurement. If an optional source is specified, the current source is modified. For the query, measures and outputs the dc RMS value of the selected waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval: an integral number of cycles or the full screen. |
| typeopt | enum | AC | DC | Selects AC RMS or DC RMS measurement. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Measurement source to use or modify. |
Returns the value at a specified time on the source specified with :MEASure:SOURce. The specified time must be on the screen and is referenced to the trigger event; if the optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| vtime_argument | real | s | Time from trigger in seconds. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernal | Source to measure from; if specified, the current source is modified. |
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 which measurement window is used when the zoomed time base is displayed. MAIN selects the upper Main window, ZOOM selects the lower Zoom window, and AUTO tries the Zoom window first and falls back to the Main window.
| 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, the current source is modified. The query returns the horizontal axis value at which the maximum vertical value occurs.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the measurement source. |
:MEASure:XMAX [<source>] :MEASure:XMAX? [<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. It is an alias for :MEASure:TMIN.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | WMEMory<r> | Selects the measurement source. |
Sets the lower measurement threshold value. The value and the UPPer value represent absolute values when thresholds are ABSolute and percentage when thresholds are PERCent as defined by :MEASure:DEFine THResholds.
| 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.
Obsolete command provided for compatibility with previous oscilloscopes. The query returns the time difference between the Tstop marker (X2 cursor) and the Tstart marker (X1 cursor), equal to Tstop - Tstart.
Selects the thresholds used when making time measurements. This command is obsolete and provided for backward compatibility; use :MEASure:DEFine THResholds instead.
| Name | Type | Values | Description |
|---|---|---|---|
| thresholds | enum | T1090 | T2080 | VOLTage | Threshold set used 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, it becomes the current source. 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 source waveform to measure. |
Installs a screen measurement and starts an X-at-Min-Y measurement on the selected waveform. If an optional source is specified, it modifies the current source; the command is obsolete and provided for backward compatibility.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | Selects the waveform source for the measurement. |
Moves the start marker (X1 cursor) to the specified time with respect to the trigger time. It is an obsolete compatibility command; the manual recommends :MARKer:X1Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | s | Time at the start marker in seconds. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Moves the stop marker (X2 cursor) to the specified time with respect to trigger time. The command is obsolete and provided for compatibility; use :MARKer:X2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | s | Time at the stop marker in seconds. |
| suffixopt | enum | s | ms | us | ns | ps | Unit suffix for the time value. |
Queries the time interval between the trigger event and a specified voltage-level crossing on the displayed signal. The command is obsolete and provided for backward compatibility; if the crossing is not found, the oscilloscope returns +9.9E+37.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The voltage level that the waveform must cross. |
| slopeopt | real | - | Direction of the waveform crossing; plus sign for rising edge, minus sign for falling edge. |
| occurrence | integer | 1 | The crossing occurrence number to be reported. |
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | Optional source channel or function to measure from. |
Sets the upper measurement threshold value. The value and the LOWer value represent absolute values when thresholds are ABSolute and percentage when thresholds are PERCent, as defined by :MEASure:DEFine THResholds.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Upper measurement threshold value. |
Returns the voltage difference between vertical marker 1 (Y1 cursor) and vertical marker 2 (Y2 cursor). The returned delta is the current value and no measurement is made when the query is received.
Moves the vertical marker (Y1 cursor) to the specified value for the selected source. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:Y1Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| vstart_argument | real | V | Value for vertical marker 1. |
Moves vertical marker 2 (Y2 cursor) to the specified value for the selected source. This obsolete command is provided for compatibility; use :MARKer:Y2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| vstop_argument | real | - | Value for the Y2 cursor. |
Specifies which channels 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 settings from :MTESt:AMASk:XDELta, :MTESt:AMASk:YDELta, and :MTESt:AMASk:UNITs. The mask only covers the portion of the waveform visible on the display.
Selects the source used to interpret :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta when :MTESt:AMASk:UNITs is set to CURRent. It is equivalent to :MTESt:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source | string | - | Source channel to use for interpreting the mask delta parameters. |
Sets the units used by the mask test subsystem when interpreting automask tolerance parameters. CURRent uses the units set by :CHANnel<n>:UNITs; DIVisions uses graticule divisions as the measurement system.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | CURRent | DIVisions | Measurement units used for automask tolerance settings. |
Sets the tolerance in the X direction around the waveform for the automasking feature. The tolerance is interpreted according to the current :MTESt:AMASk:UNITs setting.
| 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 :MTESt:AMASk:UNITs.
| 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 applies to all regions and all waveforms collected on the specified channel, or on the current source channel if no channel is given.
| Name | Type | Values | Description |
|---|---|---|---|
| channel<n>opt | channel_list | - | Optional channel number selector; <n> is 1 to the number of analog channels in NR1 format. |
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. The query returns the current mask test state.
| 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. When ON, the mask is locked to the source and is redrawn as the source scaling or position changes; when OFF, the mask remains static.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Selects whether mask lock is enabled or disabled. |
Specifies the termination condition for the mask test. The condition can be set to forever, until Sigma level, for a fixed time, or until a fixed number of waveforms are acquired.
| 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 containing a mask violation; passing waveforms do not affect measurements or statistics.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask-failure measurement mode on or off. |
Sets printing on mask failures on or off. Setting :MTESt:RMODe:FACTion:PRINt ON automatically sets :MTESt:RMODe:FACTion:SAVE OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask failure printing on or off. |
:MTESt:RMODe:FACTion:PRINt ON :MTESt:RMODe:FACTion:PRINt?
Sets saving on mask failures on or off. Setting :MTESt:RMODe:FACTion:SAVE ON automatically sets :MTESt:RMODe:FACTion:PRINt OFF.
| 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 this setting is 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 | Turns mask-failure stopping on or off. |
Sets the test sigma level used when :MTESt:RMODe is set to SIGMa. The query returns the current Sigma level setting.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.1 - 9.3 | Test sigma level 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. |
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 1 & 0 Levels control on or off. |
Defines where X=0 in the base coordinate system used for mask testing. The current X1 coordinate setting can be queried.
| Name | Type | Values | Description |
|---|---|---|---|
| x1_value | real | - | X1 value in NR3 format. |
Defines the X delta value used to position the X2 marker relative to the X1 marker in the mask test coordinate system. Redefining ΔX also moves normalized polygon vertices so they remain in the same locations with respect to X1 and ΔX.
| Name | Type | Values | Description |
|---|---|---|---|
| xdelta_value | real | - | X delta value in NR3 format. |
Defines where Y=0 in the coordinate system for mask testing. The value is a voltage specifying the point at which Y=0.
| 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 is a voltage value specifying the location of the Y2 marker.
| Name | Type | Values | Description |
|---|---|---|---|
| y2_value | real | - | 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 | discrete | - | Channel number in NR1 format. |
Sets or queries the mask title. The query returns the mask title, a string of up to 128 ASCII characters displayed in the mask test dialog box and mask test tab when a mask file is loaded.
Enables or disables averaging for test-mode acquisitions. This obsolete command is provided for backward compatibility; use :ACQuire:TYPE AVERage instead.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns averaging on or off. |
Sets the number of averages for waveforms. With AVERage acquisition type, it specifies how many data values are averaged for each time bucket before the acquisition is complete for that bucket. The command is obsolete and provided for backward compatibility; use :ACQuire:COUNt instead.
| 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 file name, up to 254 characters long including the path name if used. |
Determines the termination conditions for the mask test. The available choices are FORever, TIME, or WAVeforms; this command is obsolete and provided for backward compatibility.
| 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. When a mask test is running and a mask violation is detected, the mask test and acquisition system are stopped. This command is obsolete and provided for backward compatibility.
| 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>. |
Specifies the source for RECall operations by setting the file's base name only, without path information or an extension.
| Name | Type | Values | Description |
|---|---|---|---|
| base_name | string | - | Quoted ASCII string that names the base file for RECall operations. |
Recalls a mask. The file specification may be an internal location from 0 to 3 or a quoted ASCII file name; if a file extension is provided, it must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | Specifies the internal location or file name of the mask to recall. |
Sets the present working directory for recall operations. The query returns the currently set working directory for recall operations.
| Name | Type | Values | Description |
|---|---|---|---|
| path_name | string | - | Quoted ASCII string specifying the path name. |
Recalls an oscilloscope setup. The file specification may be an internal location integer or a quoted ASCII file name; if a file extension is provided, it must be ".scp".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification to recall, either an internal location or a quoted ASCII file name. |
Recalls a reference waveform. If a file extension is provided as part of the specified file name, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string naming the file to recall. |
Specifies the source for SAVE operations by setting the file's base name. The name is used without path information or an extension.
| Name | Type | Values | Description |
|---|---|---|---|
| base_name | string | - | Quoted ASCII string that sets the file base name. |
Saves an image. Set :SAVE:IMAGe:FORMat before saving; if the format is NONE the save will not succeed. If a file extension is provided and it does not match the current image format, the format may be changed to match a valid image extension.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string used as the file name. |
Controls whether oscilloscope factors are output along with the image. Factors are written to a separate file with the same path and base name but a ".txt" extension.
| Name | Type | Values | Description |
|---|---|---|---|
| factors | enum | OFF | 0 | ON | 1 | Enables or disables output of oscilloscope factors along with the image. |
Sets the image format type. The query returns the selected image format type; if NONE is returned, a waveform data file format is currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BMP | BMP24bit | BMP8bit | PNG | Image format type to select. |
Controls whether the graticule colors are inverted. The query returns a flag indicating whether graticule colors are inverted or not.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted or not. |
Sets the image palette color for saved images. The query returns the selected image palette color.
| Name | Type | Values | Description |
|---|---|---|---|
| palette | enum | COLor | GRAYscale | Image palette color to use for saving. |
Saves the Lister display data to a file. If a file extension is provided in <file_name>, it must be ".csv".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the file name to save to. |
Saves a mask to an internal location or a quoted file name. If a file name is specified with an extension, it must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | - | - | File specification as either an internal location or a file name. |
Saves multi-channel waveform data to a file. If a file extension is provided in the file name, it must be ".h5".
| 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 path name. |
Saves an oscilloscope setup. If a file name is provided, any file extension must be ".scp".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | discrete | - | Specifies the internal location or quoted file name to save to. |
Saves oscilloscope waveform data to a file. Set :SAVE:WAVeform:FORMat before saving; if the file extension conflicts with the expected format, the format is changed when the extension is a valid waveform file extension.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the file name. |
Sets the waveform data format type for saving waveform data. The query returns the selected waveform data format type.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | ASCiixy | CSV | BINary | Waveform data format to save. |
Sets the waveform data length, i.e. the number of points saved, when :SAVE:WAVeform:LENGth:MAX is OFF. If :SAVE:WAVeform:LENGth:MAX is ON, this setting has no effect.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 100 - max. length | Waveform data length to save, in NR1 integer format. |
Specifies whether the maximum number of waveform data points is saved. When OFF, :SAVE:WAVeform:LENGth specifies the number of waveform data points saved.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Enables or disables saving the maximum number of waveform data points. |
Specifies which acquired segments are included when a segmented waveform is saved. When segmented memory is used, ALL saves all acquired segments and CURRent saves only the currently selected segment.
| Name | Type | Values | Description |
|---|---|---|---|
| option | enum | ALL | CURRent | Selects which segments are included in the saved waveform. |
Selects the source to be saved as a reference waveform file. For the query, returns the current save source; if the source is FUNCtion or MATH, the query returns FUNC.
| 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. |
This obsolete command selects the image area used by :SAVE:IMAGe? operations. The query returns SCR for image saves and GRAT for saves of setups or waveform data.
Turns displaying of the serial decode bus on or off. The command is only valid when a serial decode option has been licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Controls whether the serial decode bus display is enabled or disabled. |
Determines the decode mode for the serial bus. It 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. |
Queries the error frame count for the selected bus channel.
Returns the overload frame count.
Resets the frame counters.
Returns the total frame count.
Queries the current CAN counter utilization for the selected SBUS<n>.
Sets the CAN sample point, the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The sample point represents the percentage of time between the beginning and end of the bit time.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 60 - 87.5 | CAN sample point setting in NR3 format. |
Sets the standard CAN signal baud rate. Rates from 10 kb/s to 4 Mb/s are accepted in 100 b/s increments, and 5 Mb/s is also allowed; values not divisible by 100 b/s are rounded to the nearest valid baud rate.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 10000 - 5000000 | Standard CAN baud rate to set. |
Sets the CAN signal type used when :SBUS<n>:CAN:TRIGger is set to SOF (start of frame). The query returns the current CAN signal type.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CANH | CANL | RX | TX | DIFFerential | DIFL | DIFH | CAN signal type to use. |
Sets the source for the CAN signal. On 2-channel DSOX1200-Series oscilloscopes only, EXTernal can be specified as the source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the CAN signal. |
Sets the CAN trigger condition for :SBUS<n>. The command accepts one of several trigger conditions such as SOF, DATA, error types, ID-based conditions, or ACK error.
| 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 pattern works with the data length set by :SBUS<n>:CAN:TRIGger:PATTern:DATA:LENGth and may be specified as binary or hexadecimal with X and $ don't-care characters.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary pattern string "nn...n" using 0, 1, X, or $; or hexadecimal pattern string "0xnn...n" using hexadecimal digits plus X and $. |
Sets the number of 8-bit bytes in the CAN data string. The value can be from 1 to 8 bytes and is set by the :SBUS<n>:CAN:TRIGger:PATTern:DATA command.
| 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 using 0, 1, and X don't-care characters.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CAN identifier pattern string, either binary (0, 1, X) or hexadecimal prefixed with 0x. |
Sets the CAN identifier mode for CAN trigger pattern ID matching. Standard selects the 11-bit identifier and Extended selects the 29-bit identifier; the identifier itself is set by :SBUS<n>:CAN:TRIGger:PATTern:ID.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STANdard | EXTended | Selects the CAN identifier mode. |
Determines whether the Read/Write bit is included as the LSB in the display of the IIC address field of the decode bus. The query returns the current IIC address width setting.
| Name | Type | Values | Description |
|---|---|---|---|
| size | enum | BIT7 | BIT8 | Sets the IIC address width setting. |
Sets the source for the IIC serial clock (SCL). EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the IIC serial clock. |
Sets the source for IIC serial data (SDA). EXTernal is available only on 2-channel DSOX1200-Series oscilloscopes.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the source for IIC serial data (SDA). |
Sets the address for IIC data. The address can be specified as an integer or as a hexadecimal string, and the don't care address can be used to ignore the address value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0x00 - 0x7F | Address value for IIC data. |
Sets the IIC trigger pattern data value. The data can be entered as an integer or as a hexadecimal string from 0x00 to 0x0FF; use -1 or 0xFFFFFFFF as a don't-care value to ignore the data.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | 0x00 - 0x0FF | IIC data pattern value to set. |
Sets IIC data 2 for the trigger pattern. The value can be specified as an integer or as a hex string from 0x00 to 0x0FF; use -1 or 0xFFFFFFFF as a don't care pattern to ignore the data value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0x00 - 0x0FF | IIC data 2 value to set. |
Sets the IIC data qualifier when TRIGger:IIC:TRIGger[:TYPE] is set to READEprom. The query returns the current IIC data qualifier value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | LESSthan | GREaterthan | IIC data qualifier to set. |
Sets the IIC trigger type. The query returns the current IIC trigger type value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STARt | STOP | READ7 | READEprom | WRITe7 | WRITe10 | NACKnowledge | ANACk | R7Data2 | W7Data2 | RESTart | IIC trigger type to set. |
Determines whether the parity bits are included as the most significant bits (MSB) in the display of the Frame Id field in the LIN decode bus.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Controls whether parity bits are included in the Frame Id display. |
Sets the LIN sample point during the bit time, expressed as a percentage of the bit time. The sample point value is not limited by the baud rate.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 60 - 87.5 | Sample point value in NR3 format; allowed values are 60, 62.5, 68, 70, 75, 80, or 87.5. |
Sets the standard baud rate of the LIN signal. Values are rounded to the nearest 100 b/s increment if necessary.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 2400 - 625000 | Baud rate to set for the LIN signal. |
Sets the source for the LIN signal. EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the LIN signal. |
Sets the LIN standard in effect for triggering and decoding. The standard can be set to LIN1.3 or LIN2.0.
| Name | Type | Values | Description |
|---|---|---|---|
| std | enum | LIN13 | LIN20 | LIN standard to use. |
Sets the length of the LIN sync break to be greater than or equal to 11, 12, or 13 clock lengths. The sync break is the idle period at the beginning of each packet that distinguishes one information packet from the previous one.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 11 - 13 | Sets the LIN sync break length in clock lengths. |
Sets the LIN trigger condition. Use SYNCbreak for Sync Break, ID for Frame ID, or DATA for Frame ID and Data.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | SYNCbreak | ID | DATA | LIN trigger condition to set. |
Defines the LIN identifier searched for in each CAN message when the LIN trigger mode is set to frame ID. Setting the ID to -1 results in 0xXX, equivalent to all IDs.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 63 | LIN identifier to search for; may also be entered as a nondecimal or string representation. |
Sets the LIN trigger data pattern searched for in each LIN data field. The pattern is entered as a string whose accepted format depends on :SBUS<n>:LIN:TRIGger:PATTern:FORMat; the query returns the currently specified pattern.
| 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 used by :SBUS<n>:LIN:TRIGger:PATTern:DATA.
| 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, and the query returns the currently set number base for LIN pattern data. The default base is BINary.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | DECimal | Sets the number base for LIN pattern data. |
Selects the SPI decode bit order used when displaying data in the serial decode waveform and in the Lister.
| Name | Type | Values | Description |
|---|---|---|---|
| order | enum | LSBFirst | MSBFirst | Sets the bit order to least-significant-bit first or most-significant-bit first. |
Sets the SPI clock source slope used to clock in data. The query returns the current SPI clock source slope.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Specifies the rising edge (POSitive) or falling edge (NEGative) 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 frames 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 for :SBUS<n>. If TIMeout is selected, the timeout value is set by :SBUS<n>:SPI:CLOCk:TIMeout; NOTC is deprecated and the same as NCHipselect.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHIPselect | NCHipselect | NOTC | TIMeout | SPI framing value to set. |
Sets the source for the SPI serial clock. On 2-channel DSOX1200-Series oscilloscopes only, EXTernal can be specified as the source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the SPI serial clock. |
Sets the source for the SPI serial data. On 2-channel DSOX1200-Series oscilloscopes that support 3-wire SPI, EXTernal may be specified as the source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the SPI serial data source. |
Sets the frame source for the SPI serial frame when :SBUS<n>:SPI:FRAMing is set to CHIPselect or NOTChipselect. EXTernal is available as the source on 2-channel DSOX1200-Series oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the frame source. |
Sets the source for the SPI serial MISO data on supported 4-channel oscilloscopes. The query returns the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Source channel for the SPI MISO data. |
Sets the source for the SPI serial MOSI data on 4-channel DSOX1200-Series oscilloscopes that support 4-wire SPI. The equivalent :SBUS<n>:SPI:SOURce:DATA command can also be used.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the source channel for MOSI data. |
Defines the SPI data pattern resource for 3-wire SPI trigger pattern search. The string parameter specifies the pattern in either binary or hexadecimal form, with X or $ treated as don't care characters.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | SPI data pattern string, either binary (0, 1, X, $) or hexadecimal when prefixed with 0x. |
Defines the SPI MISO data pattern resource for 4-wire SPI trigger pattern matching. The string may be entered as a binary pattern of 0, 1, and X, or as a hexadecimal string prefixed with "0x" using hexadecimal digits and X.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Pattern string for the SPI MISO data resource. |
Sets the width of the SPI MISO data pattern on 4-channel DSOX1200-Series oscilloscopes that support 4-wire SPI. The command should be set before :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | Width of the SPI MISO data pattern, in bits. |
Defines the SPI MOSI data pattern resource for the specified bus according to the string parameter. The pattern is used with the data width to control what is searched in the data stream; if the string starts with "0x" it is interpreted as hexadecimal, otherwise as binary.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hexadecimal pattern string using 0, 1, X, and $ characters; a leading "0x" selects hexadecimal format. |
Sets the width of the SPI MOSI data pattern on supported 4-channel DSOX1200-Series oscilloscopes. The width can be set from 4 to 64 bits and should be configured before :SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | SPI MOSI data pattern width in bits. |
Sets the width of the SPI data pattern for 3-wire SPI on supported 2-channel DSOX1200-Series oscilloscopes. The width should be set before :SBUS<n>:SPI:TRIGger:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | SPI data pattern width in bits. |
Specifies whether the SPI trigger is 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. |
Sets the number of bits in a word of SPI data. The query returns the current SPI decode word width.
| Name | Type | Values | Description |
|---|---|---|---|
| word_width | integer | 4 - 16 | Number of bits in the 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 | Sets the UART decode and Lister display base. |
Sets the UART baud rate used by the serial decoder and/or trigger when :SBUS<n> is in UART mode. The baud rate may be set from 100 b/s to 8 Mb/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 100 - 8000000 | Bit rate for the UART serial decoder and/or trigger. |
Sets the bit order used by the physical Tx and Rx input signals for the serial decoder and/or trigger when in UART mode. LSBFirst transmits the least significant bit first; MSBFirst transmits the most significant bit first.
| Name | Type | Values | Description |
|---|---|---|---|
| bitorder | enum | LSBFirst | MSBFirst | Bit order used for UART transmission. |
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) in UART decode, or turns framing off. The query returns the current UART decode base setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | <decimal> | <nondecimal> | Framing byte value or OFF. |
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 to use in UART mode. |
Selects the UART polarity as idle low or idle high for the serial decoder and/or trigger when in UART mode.
| 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. EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the UART Rx source. |
Controls which signal is used as the UART Tx source for the serial decoder and/or trigger in UART mode. EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the source signal for UART Tx. |
Sets the front panel UART/RS232 trigger setup data selection option. ASCII selects front panel data selection from ASCII values; HEX selects hexadecimal values. The setting does not affect :SBUS<n>:UART:TRIGger:DATA and is independent of :SBUS<n>:UART:BASE.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Front panel UART/RS232 trigger data selection base. |
:SBUS<n>:UART:TRIGger:BASE <base> :SBUS<n>:UART:TRIGger:BASE?
Selects the UART trigger burst value for the nth frame after an idle period. The value may be OFF or an integer from 1 to 4096.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1 - 4096 | Burst value (Nth frame after idle period) used for the UART trigger. |
Selects the UART trigger data byte value used for RD or TD trigger types in UART mode. The value can be entered as a decimal, hexadecimal, binary, or quoted ASCII character representation.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | 8-bit UART trigger data byte value. |
Selects the idle period value for burst trigger in UART mode. The query returns the current UART trigger idle period time.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 1 us - 10 s | Idle period time for burst trigger in UART mode. |
Selects the UART trigger data qualifier when :TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | GREaterthan | LESSthan | Sets the UART trigger qualifier. |
Selects the UART trigger type for :SBUS<n>. When one of the RD or TD types is selected, :SBUS<n>:UART:TRIGger:DATA and :SBUS<n>:UART:TRIGger:QUALifier are used to specify the data value and comparison operator.
| 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 used by the serial decoder and/or trigger when in UART mode. The query returns the current UART width setting.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 5 - 9 | Number of bits per message byte in UART mode. |
Sets the instrument date. Validity checking is performed to ensure that the date is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| date | string | - | Date value in <year>,<month>,<day> form. |
Returns the oscilloscope's Host ID as part of a quoted ASCII string. The exact contents and format are product-specific and should not be parsed by portable programs.
:SYSTem:DIDentifier?
Writes a quoted ASCII string to a text box in the center of the display. Use :SYSTem:DSP "" to remotely remove the message from the display.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string to display, up to 75 characters. |
:SYSTem:DSP <string>
Outputs the next error number and text from the error queue. Repeatedly querying returns errors in order until the queue is empty, after which further queries return zero until another error occurs.
Disables or enables the front panel lock. 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 which front panel softkey menu is displayed. |
Sets the manufacturer string portion of the identification string returned by *IDN?. The string is quoted ASCII and can be up to 63 characters; the query returns the currently set manufacturer string.
| Name | Type | Values | Description |
|---|---|---|---|
| manufacturer_string | string | - | Quoted ASCII manufacturer string to store. |
Sets the manufacturer string to "KEYSIGHT TECHNOLOGIES".
Places the instrument in a known state, equivalent to the front-panel Default Setup action. Some user settings remain unchanged; use *RST to reset all user settings to factory defaults.
Disables the fifty ohm impedance setting for all analog channels. The query returns the analog channel protection lock status.
| 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 | Enables or disables remote command logging. |
| file_nameopt | string | - | Quoted ASCII string specifying the log file name. |
| write_modeopt | enum | CREate | APPend | Specifies the log file write mode. |
Specifies whether remote commands are logged to a text file, to the screen, or both. If the destination is changed while remote command logging is running, logging is turned off.
| 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 their return values. The query returns 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. The ".txt" extension is added automatically to the name specified.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Quoted ASCII string specifying the file name. |
Enables or disables remote command logging. The query returns the remote command logging state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the remote command logging state. |
Specifies whether the screen display background for remote command logging is transparent or solid.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Sets the transparent screen display background setting. |
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 according to a setup (learn) string sent from the controller. The command does not change the interface mode or interface address.
| Name | Type | Values | Description |
|---|---|---|---|
| setup_data | block | - | Binary block data in IEEE 488.2 # format. |
:SYSTem:SETup <setup_data> myScope.WriteIEEEBlock ":SYSTEM:SETUP ", varSetupString
Sets the system time using a 24-hour format. Commas are used as separators, and validity checking is performed to ensure the time is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| time | integer | - | hours,minutes,seconds in NR1 format |
Sets the system time zone based on the specified offset from UTC, keeping local time constant while moving UTC. Supported offsets are listed in the manual and the query returns the current time zone offset setting.
| Name | Type | Values | Description |
|---|---|---|---|
| UTC_offset | integer | -1200 - 1200 | Integer offset from UTC in HHMM form, such as 1000 for UTC+1000 or -230 for UTC-0230. |
Ejects connected USB storage devices. When ALL is given, it dismounts/ejects all connected USB storage devices.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ALL | Eject all connected USB storage devices. |
| usb_path | string | - | Path of the USB storage device to eject. |
Returns the root path for all connected USB storage devices, delimited by a newline character. The returned string is up to 256 ASCII characters.
Sets the current time base mode. The mode can be MAIN, WINDow, XY, or 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 the maximum position value depends on the time/division setting. 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 in seconds. The range is 10 times the current time-per-division setting.
| 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. The time reference is the point on the display where the trigger point is referenced.
| Name | Type | Values | Description |
|---|---|---|---|
| reference | enum | LEFT | CENTer | RIGHt | Selects the time reference position on the display. |
:TIMebase:REFerence 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).
| Name | Type | Values | Description |
|---|---|---|---|
| vernier value | enum | 1 | ON | 0 | OFF | Sets the vernier setting to ON/1 or OFF/0. |
Sets the horizontal position in the zoomed (delayed) view of the main sweep. The value is the time from the trigger event to the zoomed view reference point and must keep the window within the main sweep range.
| 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 in seconds for the zoomed (delayed) window. The main sweep range determines the range for this command, and the maximum value is one half of the :TIMebase:RANGe value.
| Name | Type | Values | Description |
|---|---|---|---|
| range value | real | 0.5*:TIMebase:RANGe | Range value in seconds in NR3 format. |
Sets the zoomed (delayed) window horizontal scale in seconds per division. The main sweep scale determines the range for this command, and the maximum value is one half of the :TIMebase:SCALe value.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_value | real | s | Scale value in seconds in NR3 format. |
:TIMebase:WINDow:SCALe <scale_value> :TIMebase:WINDow:SCALe?
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. Holdoff prevents triggering again until a specified time has elapsed since the last trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| holdoff_time | real | 60 ns - 10 s | Holdoff time value in seconds, expressed in NR3 format. |
Automatically sets the trigger levels of all displayed analog channels to their waveforms' 50% values. If AC coupling is used, the trigger levels are set to 0 V; when high and low dual trigger levels are used, the command has no effect.
Sets the high trigger voltage level for the specified source. The query returns the high trigger voltage level for the specified source.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.75 x full-scale voltage from center screen - 0.75 x full-scale voltage from center screen | High trigger voltage level, in NR3 format, for internal triggers. |
| source | enum | CHANnel<n> | EXTernal | Trigger source to which the level applies. |
Sets the low trigger voltage level for the specified source. The query returns the low trigger voltage level for that source.
| 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> | EXTernal | Trigger source. |
Selects the trigger mode (trigger type). PATTern, SHOLd, and TRANsition modes are available on the DSOX1200-Series oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | EDGE | GLITch | PATTern | SHOLd | TRANsition | TV | SBUS1 | Trigger mode to select. |
myScope.WriteString ":TRIGger:MODE EDGE"
Turns the noise reject filter off and on. When the filter is on, the trigger circuitry is less sensitive to noise but may require a greater amplitude waveform to trigger; the command is not valid in TV trigger mode.
| 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 | Trigger sweep mode to select. |
Sets the input coupling for the selected trigger sources. The coupling can be AC, DC, or LFReject; the setting is coupled with :TRIGger[:EDGE]:REJect.
| 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, only that source’s level is changed and the active source is not changed.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.75 x full-scale voltage from center screen - ±(external range setting) | Trigger level voltage. Use the internal-trigger range for internal triggers or the external-trigger range for external triggers. |
| sourceopt | enum | CHANnel<n> | EXTernal | Optional source whose trigger level is set. |
Turns the low-frequency or high-frequency reject filter on or off. Only one reject filter can be on at a time, and the reject and coupling settings are coupled.
| Name | Type | Values | Description |
|---|---|---|---|
| reject | enum | OFF | LFReject | HFReject | Selects the reject filter state. |
:TRIGger[:EDGE]:REJect <reject> :TRIGger[:EDGE]:REJect?
Specifies the slope of the edge used for the trigger. It is not valid in TV trigger mode; use :TRIGger:TV:POLarity instead.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | ALTernate | Sets the trigger edge slope. |
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"
Selects the input that produces the trigger. The query returns the current source, or "NONE" if all channels are off.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | LINE | WGEN | Input source used to produce the trigger. |
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. |
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 | - | Maximum pulse width duration. |
Sets the trigger level voltage for the active pulse width trigger. The query returns the trigger level of the current pulse width trigger mode, or "NONE" if all channels are off.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | V | Trigger level voltage for internal triggers, or ±(external range setting) for external triggers. |
| sourceopt | enum | CHANnel<n> | EXTernal | Selects the source channel or external input for the trigger level. |
Sets the polarity for the glitch pulse width trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Sets the glitch pulse width trigger polarity. |
Sets the mode of operation of the glitch pulse width trigger. The oscilloscope can trigger on a pulse width that is greater than a time value, less than a time value, or within a range of time values.
| Name | Type | Values | Description |
|---|---|---|---|
| operator | enum | GREaterthan | LESSthan | RANGe | Selects whether the trigger qualifies on greater than, less than, or range of pulse width. |
Sets the pulse width duration for the selected :TRIGger:GLITch:SOURce. The two time values may be entered in any order; the smaller value becomes <greater_than_time> and the larger becomes <less_than_time>.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | 15 ns - 10 seconds | Upper pulse-width duration limit. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower pulse-width duration 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> | Channel that produces the pulse width trigger. |
Specifies the channel values used in the pattern trigger. The optional edge source and edge parameters may be sent together with the pattern string, and they take precedence over the ASCII string edge notation.
| Name | Type | Values | Description |
|---|---|---|---|
| pattern | string | - | Pattern string, with optional edge source and edge when using HEX format. |
Sets the entry and query number base used by the :TRIGger:PATTern command. The default base is ASCii.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Number base used for pattern trigger patterns. |
Qualifies when the trigger occurs. On InfiniiVision 1200 X-Series and EDUX11052A/G oscilloscopes, the trigger always occurs when the pattern is entered.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | ENTered | Specifies the trigger duration qualifier. |
Specifies whether the rising edge or the falling edge of the clock signal is used.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the edge polarity used for trigger hold slope. |
Selects the input channel used to probe the clock signal. The query returns the currently set clock signal source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Input channel probing the clock signal. |
Selects the input channel used to probe the data signal. The query returns the currently set data signal source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Input channel to use as the data signal source. |
Sets the hold time for the trigger hold-time function. The query returns the currently specified hold time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Hold time value in NR3 floating-point format. |
Sets the setup time. The query returns the currently specified setup time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Setup time value in NR3 floating-point format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Specifies whether the rise/fall time trigger uses a greater-than or less-than qualifier. The time value is set with :TRIGger:TRANsition:TIME.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | Selects whether the trigger looks for times greater than or less than the specified time value. |
Specifies a positive rising edge or a negative falling edge transition trigger slope. The query returns the current rise/fall time trigger slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the trigger slope polarity. |
Selects the channel used to produce the trigger. The query returns the current transition trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Channel to use as the trigger source. |
Sets the time value for rise/fall time triggers. Use :TRIGger:TRANsition:QUALifier to specify whether the trigger condition is greater than or less than this value.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | s | Floating-point time value in NR3 format. |
Sets the video trigger to occur on a specific line of video. The valid line number range depends on the TV standard and mode.
| Name | Type | Values | Description |
|---|---|---|---|
| line_number | integer | 1 - 625 | Line number to trigger on, expressed as an integer in NR1 format. |
:TRIGger:TV:LINE <line_number> :TRIGger:TV:LINE?
Selects the TV trigger mode and field. The query returns the current TV trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FIEld1 | FIEld2 | AFIelds | ALINes | LFIeld1 | LFIeld2 | LALTernate | TV trigger mode and field to select. |
Sets the polarity for the TV trigger. The query returns the TV trigger polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Selects the TV trigger polarity. |
Selects the channel used to produce the TV trigger. The query returns the current TV trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel used to produce the trigger. |
Selects the video standard used for TV trigger operation. The query returns the current TV trigger standard setting.
| Name | Type | Values | Description |
|---|---|---|---|
| standard | enum | NTSC | PALM | PAL | SECam | Video standard to select. |
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. |
Sets the output byte order for WORD waveform data. The setting affects transmission only when :WAVeform:FORMat WORD is selected; default is MSBFirst.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | LSBFirst | MSBFirst | Selects whether the least significant or most significant byte is transmitted first. |
Returns the count used to acquire the current waveform. For all acquisition types except average, the value is 1.
Returns the sampled waveform data as an IEEE 488.2 arbitrary binary block. The data format depends on :WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and :WAVeform:SOURce, and the number of points is controlled by :WAVeform:POINts.
:WAV:DATA?
Sets the waveform data transmission format. The query returns the current output format for waveform data transfer.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | WORD | BYTE | ASCii | Selects how waveform data points are formatted for transfer. |
:WAVeform:FORMat <value> :WAVeform:FORMat?
Sets the number of waveform points transferred with the :WAVeform:DATA? query. The allowed values depend on the waveform points mode; the <points mode> option is deprecated in favor of :WAVeform:POINts:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| points | integer | 100 - 2000000 | Number of waveform points to transfer; allowed values depend on waveform points mode and may also be one of the deprecated points-mode keywords. |
| modeopt | enum | NORMal | MAXimum | RAW | Deprecated points-mode keyword accepted in place of a numeric point count. |
:WAVeform:POINts 1000
Sets the waveform data record transfer mode used by the :WAVeform:DATA? query. NORMal selects the measurement record, RAW selects the raw acquisition record, and MAXimum selects whichever record contains the most points.
| Name | Type | Values | Description |
|---|---|---|---|
| points_mode | enum | NORMal | MAXimum | RAW | Selects which data record is transferred. |
Requests the preamble information for the selected waveform source. The preamble contains the vertical and horizontal scaling information for the corresponding channel data.
myScope.WriteString ":WAVEFORM:PREAMBLE?" ' Query for the preamble.
Returns the number of memory segments in the acquired data. It can be used while segments are still being acquired.
Returns the time tag of the currently selected segmented memory index. The selected index is set with :ACQuire:SEGMented:INDex.
Selects the analog channel, function, or reference waveform to be used as the source for the :WAVeform commands. EXT is available on 2-channel oscilloscopes only.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r> | SBUS1 | ABUS | EXT | Source used by the waveform commands. |
myScope.WriteString ":WAVEFORM:SOURCE CHAN1"
Selects which serial decode waveform subsource is used when :WAVeform:SOURce is an SBUS<n> source. SUB0 is the default; TX/MISO are aliases for SUB1, and RX/MOSI are aliases for SUB0.
| Name | Type | Values | Description |
|---|---|---|---|
| subsource | enum | SUB0 | RX | MOSI | SUB1 | TX | MISO | Chooses the waveform subsource to display or decode. |
Returns the acquisition mode associated with the currently selected waveform. The acquisition mode is set by the :ACQuire:TYPE command.
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 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.
Returns the y-origin value for the currently specified source. This is the Y-axis value of the data value specified by :WAVeform:YREFerence; for this product, it is the Y-axis value of the center of the screen.
Returns the y-reference value for the currently specified source. This value specifies the data point value where the y-origin occurs; it is undefined if the format is ASCii.
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 | Frequency of the waveform 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 | Sets the waveform type. |
Specifies the pulse width for Pulse waveforms. The 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. The value is the amount of time per cycle that the ramp waveform is rising.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | integer | 0 - 100 | Symmetry percentage in NR1 format. |
Sets the square wave duty cycle for the waveform generator. The duty cycle is adjustable from 1% to 99% in NR1 format, with the usable range narrowing at higher frequencies.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 1% - 99% | Duty cycle percentage to set for the square waveform. |
Specifies the amount of amplitude modulation as a percentage of the amplitude range used by the modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | AM depth percentage in NR1 format. |
Specifies the frequency of the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency in NR3 format. |
Sets the FM frequency deviation from the original carrier signal frequency. The deviation is limited by the original carrier frequency and by the maximum frequency of the selected waveform generator function plus 100 kHz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Frequency deviation in Hz, in NR3 format. |
Specifies the frequency of the modulating signal in Hz. The query returns the frequency of the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency in NR3 format. |
Specifies the hop frequency used for frequency-shift keying modulation. The output frequency shifts between the original carrier frequency and this hop frequency.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Hop frequency in NR3 format. |
Specifies the FSK modulation rate, i.e. the rate at which the output frequency shifts. The rate is given in Hz in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | FSK modulation rate in Hz in NR3 format. |
Sets the shape of the modulating signal. This command applies to AM and FM modulation; the RAMP shape can be further controlled with :WGEN:MODulation:FUNCtion:RAMP:SYMMetry.
| Name | Type | Values | Description |
|---|---|---|---|
| shape | enum | SINusoid | SQUare | RAMP | Specifies the modulating signal shape. |
Sets the ramp modulation symmetry percentage, which determines the amount of time per cycle that the ramp waveform is rising. The ramp modulating waveform shape is specified with :WGEN:MODulation:FUNCtion.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | Symmetry percentage. |
Adds noise to the currently selected waveform generator signal. The noise percentage range is 0 to 100, but the effective range varies with the current amplitude limit.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0 - 100 | Percentage of added noise. |
Enables or disables modulated waveform generator output. Modulation can be enabled for all waveform generator function types except pulse, DC, and noise.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Enables or disables modulation. |
Selects the modulation type for the waveform generator. The query returns the currently selected modulation type.
| 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).
| 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 display of amplitude and offset levels. The Gen Out BNC output impedance itself is fixed at 50 ohms.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
Specifies whether the waveform generator output is inverted.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | NORMal | INVerted | Sets the waveform generator output polarity. |
Sets the waveform generator period for all waveforms except Noise and DC. The period can also be specified indirectly with :WGEN:FREQuency.
| Name | Type | Values | Description |
|---|---|---|---|
| period | real | s | Period of the waveform in 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 :WGEN:VOLTage:OFFSet to specify the offset voltage or DC level, or :WGEN:VOLTage:HIGH and :WGEN:VOLTage:LOW to specify amplitude indirectly.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Waveform amplitude in volts, expressed in NR3 format. |
Sets the waveform high-level voltage for all waveforms except DC. The high-level and low-level voltages can also be specified indirectly using :WGEN:VOLTage and :WGEN:VOLTage:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| high | real | V | High-level voltage in volts, in NR3 format. |
Specifies the waveform low-level voltage for all waveforms except DC. Use :WGEN:VOLTage:HIGH to specify the high-level voltage; the high and low levels may also be set indirectly with :WGEN:VOLTage and :WGEN:VOLTage:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| low | real | V | Low-level voltage in volts, in NR3 format. |
Specifies the waveform offset voltage, also described as the DC level. The query returns the currently specified waveform offset voltage.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | V | Offset voltage in NR3 format. |
Clears the specified reference waveform location.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform location number in NR1 format. |
Turns the display of the specified reference waveform on or off. Only one reference waveform can be displayed at a time; enabling one reference waveform automatically turns the other off.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform location number. |
| on_off | enum | 1 | ON | 0 | OFF | Display state to set for the selected reference waveform. |
Sets the reference waveform label to the quoted ASCII string that follows. Label strings are limited to 10 characters; longer labels are truncated and lowercase characters are converted to uppercase.
| 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 |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion | MATH | Selects the analog channel or math function waveform 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 | Skew value in seconds in NR3 format. |
Sets the value represented at center screen for the selected reference waveform. If the value is outside the legal range, it is automatically adjusted to the nearest legal value; legal values depend on :WMEMory<r>:YRANge, :WMEMory<r>:YSCale, and probe attenuation.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - 2 | Reference waveform number in NR1 format. |
| offset | real | - | Vertical offset value in NR3 format. |
| suffixopt | enum | V | mV | Units for the offset value. |
Defines the full-scale vertical axis of the selected reference waveform. Legal values for the range 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 for the range value. |
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 | - | Vertical units per division in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix for the scale. |
Sets the source text for CHANnel1 or CHANnel2 to the quoted ASCII string that follows. This obsolete command is provided for compatibility with previous oscilloscopes; use :CHANnel<n>:LABel instead.
| Name | Type | Values | Description |
|---|---|---|---|
| source_text | enum | CHANnel1 | CHANnel2 | Selects which analog channel label source text is set. |
| string | string | - | Quoted ASCII label text to assign. |
Sets the skew between channels 1 and 2. This obsolete compatibility command is only valid for two-channel oscilloscope models; use :CHANnel<n>:PROBe:SKEW instead.
| Name | Type | Values | Description |
|---|---|---|---|
| skew value | real | -100 ns - +100 ns | Skew time in NR3 format. |
Erases the screen. This is an obsolete command provided for compatibility with previous oscilloscopes; use :DISplay:CLEar instead.