Clears the status data structures, the device-defined error queue, and the Request-for-OPC flag. If *CLS immediately follows a program message terminator, the output queue and MAV bit are also cleared.
SCPI COMMAND REFERENCE
The Keysight DSOX4022G is Keysight's oscilloscope in the InfiniiVision 4000G X-Series family. Its SCPI remote-control interface exposes 1067 commands across 60 subsystems - 1065 settable and 2 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.
1,067
Commands
1,065
Settable
2
Queries
60
Subsystems
SCPI
Verified
2026-07-16
All commands
Sets the bits in the Standard Event Status Enable Register. A 1 enables the corresponding bit in the Standard Event Status Register; 0 disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask_argument | integer | 0 - 255 | Mask value written to the Standard Event Status Enable Register. |
Returns the contents of the Standard Event Status Register as the total bit weight of all bits that are high when read. Reading the register clears it.
The *IDN? query identifies the instrument type and software version.
Returns the current state of the instrument as a valid command string that can later be used to restore the setup. The result includes ":SYST:SET " followed by IEEE 488.2 binary block data.
Sets the operation complete bit in the Standard Event Status Register when all pending device operations have finished. The *OPC? query places an ASCII "1" in the output queue when all pending operations are complete.
Reports the options installed in the instrument. The query returns a string identifying the module and its software revision level.
*OPT?
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 state, equivalent to the factory default front-panel setup. It resets many acquisition, channel, display, time base, and trigger settings to their default values.
*RST
Stores the current state of the instrument in a save register. The value specifies the register where the data will be saved.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 9 | Save register number. |
Sets the bits in the Service Request Enable Register, which controls which Status Byte Register bits can generate a service request. A one enables the corresponding bit and a zero disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | 0 - 255 | Mask value with bits defined by the Service Request Enable Register table. |
Returns the current value of the instrument's status byte. The MSS bit is reported on bit 6 instead of the RQS bit when queried with *STB?.
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 and a non-zero value indicates failure.
Waits for all pending commands to complete before continuing. In this oscilloscope, the command has no function and is parsed only for compatibility with other instruments.
Clears the cumulative edge variables for the next activity query. The query returns whether there has been edge activity on the digital channels since the last :ACTivity? query, along with the current logic levels.
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 the input signals and sets the correct conditions to display them, equivalent to pressing the front-panel Auto Scale key. If one or more sources are specified, those sources are enabled and all others are blanked.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | DIGital<d> | POD1 | POD2 | CHANnel<n> | Input source to autoscale; may be repeated up to 5 times. |
myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key.
Specifies the acquisition mode that is set by subsequent :AUToscale commands. When NORMal is selected, autoscale sets the NORMal acquisition type and RTIMe mode; when CURRent is selected, the current acquisition type and mode are kept.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | NORMal | CURRent | Acquisition mode to be set by subsequent autoscale operations. |
Specifies which channels will be displayed on subsequent autoscale operations. ALL autoscales all channels that meet the autoscale requirements; DISPlayed autoscales only channels that are turned on.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ALL | DISPlayed | Selects which channels are included in subsequent autoscale operations. |
Turns fast debug autoscaling on or off. The Fast Debug option changes :AUToscale behavior to help quickly determine whether the probed signal is DC voltage, ground, or an active AC signal, while maintaining channel coupling for easier viewing of oscillating signals.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns fast debug auto scaling on or off. |
Turns off the specified channel, digital pod, math function, serial decode bus, or reference waveform location. With no parameter, it turns off all sources.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r> | Source to blank. |
Causes the instrument to acquire waveforms according to the :ACQuire settings, then stop when the acquisition is complete. If no argument is given, it acquires the currently displayed channels; if none are displayed, it acquires all channels.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | Source to acquire on DSO models. |
| sourceopt | enum | CHANnel<n> | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | Source to acquire on MSO models. |
myScope.WriteString ":DIGitize CHANnel1"
Sets the Hardware Event Enable register mask. Setting bit 12 enables PLL Locked hardware event reporting and can potentially generate an SRQ.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 16-bit integer mask written to the Hardware Event Enable register. |
Returns the integer value contained in the Hardware Event Condition Register.
Returns the integer value contained in the Hardware Event Event Register.
Sets the Mask Test Event Enable register with a 16-bit integer mask. Setting selected bits enables bit 9 in the Operation Status Condition Register and may generate an SRQ interrupt.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 16-bit integer mask to write to the Mask Test Event Enable register. |
Returns the integer value contained in the Mask Test Event Register and clears the register.
Sets a mask in the Operation Status Enable register. Setting selected bits enables bit 7 in the Status Byte Register and can generate an SRQ interrupt.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | 0 - 32767 | 15-bit integer mask to load into the Operation Status Enable register. |
Returns the integer value contained in the Operation Status Condition Register.
Reads and clears the integer value contained in the Operation Status Event Register.
Sets the overload event enable mask in the Overload Event Enable Register and enables reporting of the Overload Event Register. The mask is a 16-bit integer.
| Name | Type | Values | Description |
|---|---|---|---|
| enable_mask | integer | - | 16-bit integer enable mask representing input events to enable. |
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. If an option is not specified, the value selected in the Print Config menu is used.
| Name | Type | Values | Description |
|---|---|---|---|
| print option | enum | COLor | GRAYscale | PRINter0 | PRINter1 | BMP8bit | BMP | PNG | NOFactors | FACTors | Print format option; may be repeated up to 5 times. |
Queries the printer/image transfer options used for pulling image data back over the bus for storage. This obsolete compatibility command is not a core command; the manual recommends :DISPlay:DATA instead.
| Name | Type | Values | Description |
|---|---|---|---|
| optionsopt | enum | COLor | GRAYscale | BMP8bit | BMP | One or more print options to apply, separated by commas. |
Returns the oscilloscope run state.
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 channel, function, serial decode bus, or reference waveform location is displayed. The query applies to DSO or MSO source types as listed in the syntax.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r> | Displayed source to check for visibility. |
Stops the acquisition. This is the same as pressing the Stop key on the front panel.
Reads the Trigger Event Register and then clears it. A one indicates a trigger has occurred; a zero indicates no trigger has occurred.
Turns on the specified channel, function, serial decode bus, or reference waveform location. For MSO models, digital channels and pods are also valid sources; MATH<m> is an alias for FUNCtion<m>.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r> | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | Source to display. |
:VIEW CHANnel1
Returns the current state of the oscilloscope acquisition anti-alias control. The control can be directly disabled or disabled automatically.
Specifies the minimum completion criteria for an acquisition used by :DIGitize. The only legal value is 100, meaning all time buckets must contain data before the acquisition is considered complete.
| Name | Type | Values | Description |
|---|---|---|---|
| complete | integer | 100 - 100 | Completion criteria for the acquisition; only 100 is allowed. |
:ACQuire:COMPlete 100 :ACQuire:COMPlete 100
Sets the number of values to be averaged for each time bucket in averaging mode. When :ACQuire:TYPE is AVERage, the count can be set from 2 to 65536; the command :ACQuire:COUNt 1 is deprecated.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 65536 | Number of values to be averaged for each time bucket. |
Sets the oscilloscope's disable anti-alias mode. DISable keeps anti-alias always disabled; AUTO lets the oscilloscope turn off anti-alias control as needed.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DISable | AUTO | Disable anti-alias mode setting. |
Turns Digitizer mode on or off. In Digitizer mode, the user chooses the acquisition sample rate and memory depth instead of using automatic time/division-based settings.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets Digitizer mode to off or on. |
Sets the oscilloscope acquisition mode. The available modes are real time, equivalent time, and segmented memory mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | RTIMe | ETIMe | SEGMented | Acquisition mode to set. |
Sets the desired acquisition memory depth. AUTO selects the oscilloscope's automatic mode, while a numeric value puts it into digitizer/manual mode with the specified number of points.
| Name | Type | Values | Description |
|---|---|---|---|
| points | integer | AUTO | Desired analog memory depth in integer NR1 format, or AUTO for automatic mode. |
Enables or disables automatic determination of the analog channel memory depth. ON uses the oscilloscope's automatic mode; OFF sets memory depth using :ACQuire:POINts[:ANALog].
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns automatic analog memory-depth determination on or off. |
Selects the 10 MHz reference signal mode. OFF disables the oscilloscope's 10 MHz REF BNC connector, OUT is used to synchronize the timebase of two or more instruments, and IN supplies a sample clock to the oscilloscope.
| Name | Type | Values | Description |
|---|---|---|---|
| ref_signal_mode | enum | OFF | OUT | IN | Selects the 10 MHz reference signal mode. |
Calculates measurement statistics and/or infinite persistence over all acquired segments. The oscilloscope must be stopped and in segmented acquisition mode, with either quick measurements or infinite persistence on.
Sets the number of memory segments to acquire in segmented acquisition mode. The query returns the current count setting.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 1000 | Number of memory segments to acquire. |
Sets the index into the acquired memory segments. The segmented memory acquisition mode must be enabled separately, and the query form returns the current segmented memory index setting.
| Name | Type | Values | Description |
|---|---|---|---|
| index | integer | 1 - 1000 | Index into the memory segments that have been acquired. |
Sets the desired acquisition sample rate. AUTO puts the oscilloscope into Automatic mode; a numerical sample rate puts it into Digitizer mode with the desired rate.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | enum | AUTO | Desired acquisition sample rate or AUTO mode. |
Enables or disables automatic determination of the analog channel sample rate. ON uses automatic mode based on the horizontal time/div setting; OFF sets the sample rate using :ACQuire:SRATe[:ANALog].
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables automatic analog sample rate determination. |
Selects the type of data acquisition to take place. The available acquisition types are normal, averaging, high-resolution, and peak detect.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NORMal | AVERage | HRESolution | PEAK | Acquisition type to set. |
:ACQuire:TYPE NORMal
Includes or excludes the selected digital bit in the definition for the specified bus. On MSO models only.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Selects whether the bit is included (1/ON) or excluded (0/OFF) from the bus definition. |
myScope.WriteString ":BUS1:BIT1 ON"
Includes or excludes selected digital channels in the definition of the specified bus. The query returns the current bus bit definition.
| Name | Type | Values | Description |
|---|---|---|---|
| channel_list | channel_list | - | List of digital channels or bit ranges affected by the command. |
| display | enum | 1 | ON | 0 | OFF | Specifies whether the selected channels are included or excluded from the bus definition. |
:BUS1:BITS (@1,2,4:9), ON :BUS1:BITS (@1,5,7,9), ON :BUS1:BITS (@1:15), ON :BUS1:BITS (@1:5,8,14), ON
Excludes all digital channels from the selected bus definition. The bus number suffix <n> must be 1 or 2 and is attached to BUS.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Bus number that identifies the bus affected by the command. |
Enables or disables the view of the selected bus. This command is only valid for the MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Enables or disables the bus display. |
Sets the specified bus label to a quoted ASCII string 10 characters or less. For MSO models only, the label is also added to the label list.
| Name | Type | Values | Description |
|---|---|---|---|
| quoted_string | string | - | Bus label as a quoted ASCII string up to 10 characters. |
myScope.WriteString ":BUS1:LABel 'Data'"
Defines the bits included and excluded in the selected bus according to the mask. Set a mask bit to 1 to include that bit in the selected bus, and 0 to exclude it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 32-bit mask value in decimal, nondecimal (#H or #B), or quoted hexadecimal string. |
Returns the date of the last calibration.
Saves a calibration label string into the instrument's non-volatile memory. The label may be used to record calibration dates or other information, and can be up to 32 characters long.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string up to 32 characters long, not including the quotes. |
Sets the signal available on the rear-panel TRIG OUT BNC. The selected source can be trigger events, mask test failure indication, waveform generator sync output, or the raw trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | TRIGgers | MASK | WAVEgen | WGEN1 | WGEN2 | TSOurce | Selects the TRIG OUT source. |
Returns the rear-panel calibration protect button state. PROTected indicates calibration is disabled, and UNPRotected indicates calibration is enabled.
Starts the user calibration procedure.
Returns the summary results of the last user calibration procedure.
Returns the change in temperature since the last user calibration procedure.
Returns the time of the last calibration.
Sets or queries the channel low-pass bandwidth limit. Values of 20E6 or lower enable 20 MHz bandwidth limiting; values above 20E6 disable bandwidth limiting and restore full bandwidth.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | - | Bandwidth limit value in NR3 format. |
Controls an internal low-pass filter for the specified channel. When the filter is on, the channel bandwidth is limited to approximately 25 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| bwlimit | enum | 1 | ON | 0 | OFF | Sets the low-pass filter state. |
Selects the input coupling for the specified analog channel. Each channel can be set to AC or DC.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | AC | DC | Input coupling for the specified channel. |
| 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 | Display state to set for the specified channel. |
| n | integer | 1 - (# analog channels) | Specifies the channel number in NR1 format. |
Selects the input impedance setting for the specified analog channel.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Sets the input impedance to 1 MΩ or 50 Ω. |
Selects whether to invert the input signal for the specified channel. The inversion may be enabled or disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| invert value | enum | 1 | ON | 0 | OFF | Specifies whether channel inversion is on or off. |
Sets the analog channel label to the specified quoted ASCII string. Labels are limited to 32 characters; longer labels are truncated and the label is also added to the non-volatile label list.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string used as the channel label. |
myScope.WriteString ":CHANnel1:LABel ""CAL 1""" ' Label ch1 "CAL 1". myScope.WriteString ":CHANnel2:LABel ""CAL2""" ' Label ch1 "CAL2".
Sets the vertical offset represented at center screen for the selected channel. If the requested value is outside the legal range, the instrument automatically sets it to the nearest legal value; legal values depend on the channel range, scale, and probe attenuation settings.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Vertical offset value in NR3 format. |
| suffixopt | enum | V | mV | Unit suffix for the offset value. |
Specifies the probe attenuation factor for the selected channel. The factor may be from 0.001 to 10000, and obsolete attenuation values X1, X10, X20, and X100 are also supported.
| Name | Type | Values | Description |
|---|---|---|---|
| attenuation | real | 0.001 - 10000 | Probe attenuation ratio in NR3 format. |
myScope.WriteString ":CHANnel1:PROBe 10" ' Set Probe to 10:1.
Sets the probe's quick-action button mode for N275xA InfiniiMode probes. The setting controls what the probe's quick-action button does when pressed, such as headlight control, InfiniiMode cycling, run/stop, single acquisition, autoscale, force trigger, or no action.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | HEADlight | INFiniimode | RSTop | SINGle | CDISplay | AUToscale | FTRigger | QACTion | NACTion | NONE | Quick-action button mode to assign to the probe. |
Begins the probe degauss operation. For use with the N7026A and N2893A probes only.
Enables or disables External Scaling on the analog input channel. External Scaling can apply additional gain to the input channel to account for attenuators, adapters, and other probing-system components.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Enables or disables External Scaling. |
Sets the gain associated with External Scaling for the selected channel. The query returns the External Scaling gain setting.
| Name | Type | Values | Description |
|---|---|---|---|
| gain_factor | real | 0.0001 - 1000 | Gain factor to set, expressed as a real number in NR3 format. |
Sets the vertical offset associated with External Scaling.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Offset value at center screen in NR3 format. |
Sets the measurement units for the connected external probe on the specified channel. Select VOLT for a voltage probe or AMPere for a current probe; measurement results, channel sensitivity, and trigger level reflect the selected units.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Channel number in NR1 format. |
| units | enum | VOLT | AMPere | Measurement units for the connected probe. |
Sets the analog channel probe head type and dB value for the selected channel. Query form returns the current probe head type setting. This command is valid only for 113xA Series probes.
| Name | Type | Values | Description |
|---|---|---|---|
| head_param | enum | SEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | DSMA | DSMA6 | NONE | Probe head type and dB value to set. |
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 model number of the supported Tektronix probe for the specified channel. The query returns the current model number setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | P5205 | P5210 | P6205 | P6241 | P6243 | P6245 | P6246 | P6247 | P6248 | P6249 | P6250 | P6251 | P670X | P671X | TCP202 | Model number of the supported Tektronix probe. |
Sets the N275xA InfiniiMode probe's mode for the specified channel. The query returns the probe mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Channel number in NR1 format. |
| setting | enum | DIFFerential | DOFFset | SEA | SEB | CM | Probe mode to select. |
Sets the R-sense resistor value probed in the DUT when the N2820A high-sensitivity current probe is used with the N2825A user-defined R-sense head. The supported R-sense resistor values are from 1 ma9 to 1 Ma9.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 1 ma9 - 1 Ma9 | Ohms value in NR3 format. |
Sets the probe skew factor for the specified analog channel. Each channel can be adjusted from -100 ns to +100 ns to remove cable-delay errors between channels.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Channel number to configure. |
| skew value | real | -100 ns - +100 ns | Skew time to apply to the selected channel. |
Sets the channel probe signal type to differential or single-ended for 113xA Series probes, which determines how offset is applied. The command is valid only for the 113xA Series probes.
| Name | Type | Values | Description |
|---|---|---|---|
| signal type | enum | DIFFerential | SINGle | Selects the probe signal type. |
Specifies whether the selected probe cable uses the Zoom In waveform or the Zoom Out waveform when the N2820A high-sensitivity current probe is used with both the Primary and Secondary cables. The other cable uses the opposite waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Channel number in NR1 format. |
| state | enum | 0 | OFF | 1 | ON | Selects Zoom Out (0/OFF) or Zoom In (1/ON). |
Clears (resets) the channel overload protection so the input can be used again in 50 Ω mode after an overload has been removed. The query returns the protection state for the selected channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Channel number in NR1 format. |
Defines the full-scale vertical axis range of the selected channel. If probe attenuation is changed, the programmed range is multiplied by the probe attenuation factor.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | 8 mV - 40 V | Vertical full-scale range value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix appended to the range value. |
myScope.WriteString ":CHANnel1:RANGe 8" ' Set the vertical range to 8 volts.
Sets the vertical scale, or units per division, of the selected channel. If the probe attenuation is changed, the scale value is multiplied by the probe's attenuation factor.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - (# analog channels) | Channel number to select. |
| scale | real | - | Vertical units per division in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix. |
Sets the measurement units for the connected probe on the specified channel. The selected units affect measurement results, channel sensitivity, and trigger level.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units for the connected probe. |
Sets whether the selected channel's vernier (fine vertical adjustment) is on or off. The query returns the current vernier state.
| Name | Type | Values | Description |
|---|---|---|---|
| vernier value | enum | 1 | ON | 0 | OFF | Turns the channel vernier setting on or off. |
Selects the input impedance setting for the specified channel. This obsolete command is provided for compatibility with previous oscilloscopes; use :CHANnel<n>:IMPedance instead.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Input impedance setting for the specified channel. |
Sets the probe sense mode for the specified channel. This is an obsolete compatibility command; the mode is controlled internally and a conflict error is generated if the requested setting does not match the oscilloscope's setting.
| Name | Type | Values | Description |
|---|---|---|---|
| pmode value | enum | AUTo | MANual | Probe sense mode to set. |
| n | integer | 1 - (# analog channels) | Channel number in NR1 format. |
Automatically sets up the oscilloscope for the selected signal quality test and USB compliance test packets. It sets horizontal scale/delay, analog channel scale/offset, and trigger mode/level, then causes the oscilloscope to run.
Specifies the number of internal hubs between the host and the test point. For Near-end test type, you can specify 0 to 5 hubs; for Far-end test type, the number is set to 0.
| Name | Type | Values | Description |
|---|---|---|---|
| number | integer | 0 - 5 | Number of internal hubs in NR1 format. |
Runs the selected USB signal quality test. The oscilloscope stops acquisitions if they are running, analyzes the data on screen, and displays the results; tests may take several minutes.
Specifies the analog input channel that probes the adjacent D+ or D- signal for USB compliance testing. For Device Full Speed Signal Quality it probes D+, and for Device Low Speed Signal Quality it probes D-.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Analog input channel to use as the adjacent signal probe. |
Specifies the analog input channel whose differential probe is connected to the Hi-Speed signal to be tested.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel to use as the differential probe source. |
Specifies the analog input channel that is probing the D- signal. On 4-channel oscilloscopes, different channel pairs must be used for the D+ and D- signals to achieve maximum sample rate.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel used for the D- signal. |
Specifies which analog input channel probes the USB D+ signal. On 4-channel oscilloscopes, different channel pairs must be used for the D+ and D- signals to achieve the maximum sample rate.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel assigned to probe the D+ signal. |
Selects the USB signal quality test type to perform. The query returns the currently selected test type.
| Name | Type | Values | Description |
|---|---|---|---|
| test | enum | DHSS | HHSS | DLSS | HLSS | DFSS | HFSS | USB signal quality test type to perform. |
Specifies the USB compliance test fixture connection type for a selected Hi-Speed test. Use DIFFerential for a differential probe or SINGleended for two single-ended SMA cables.
| Name | Type | Values | Description |
|---|---|---|---|
| connection | enum | SINGleended | DIFFerential | Specifies the test fixture connection type. |
Selects whether a Hi-Speed USB test is near-end or far-end when a Hi-Speed test has been selected. The query returns the selected test type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NEARend | FARend | Selects the USB test type. |
Returns the current counter value.
Enables or disables the counter feature.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether the counter is enabled or disabled. |
Sets the counter mode. FREQuency selects cycles per second (Hz), and PERiod selects the signal cycle period.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FREQuency | PERiod | Counter mode to set. |
Sets the number of digits of resolution used for the frequency or period counter. The resolution is normally 5 digits and can be increased to 8 digits when a 10 MHz reference signal is applied.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 5 - 8 | Number of digits of resolution to use. |
Selects the waveform source that the counter measures. You can choose an analog input channel or the trigger qualified event signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | TQEVent | Waveform source used by the counter. |
Selects the type of demo signal. The allowed signal keywords include waveform, bus, and interface demo types such as SINusoid, AM, SPI, USBPd, and KEYSight.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | SINusoid | NOISy | PHASe | RINGing | SINGle | AM | CLK | GLITch | BURSt | MSO | RUNT | TRANsition | RFBurst | SHOLd | LFSine | FMBurst | ETE | CAN | LIN | UART | I2C | SPI | I2S | CANLin | CXPI | ARINc | FLEXray | MANChester | MIL | MIL2 | USB | NMONotonic | DCMotor | HARMonics | COUPling | CFD | SENT | USBPd | KEYSight | Specifies the demo signal function to select. |
Sets the phase shift of the second sine waveform for the phase-shifted sine demo signals. The value is specified in degrees from 0 to 360 in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| angle | real | 0 - 360 | Phase shift angle for the second sine waveform. |
Specifies whether the demo signal output is ON (1) or OFF (0).
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns the demo signal output on or off. |
:DEMO:OUTPut <on_off> :DEMO:OUTPut?
Turns the digital display on or off for the specified channel. This command is only valid for the MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel number in NR1 format. |
| display | enum | 1 | ON | 0 | OFF | Turns the digital display on or off. |
Sets the label for the specified digital channel, and stores the label in the non-volatile label list. The query returns the name of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel number in NR1 format. |
| string | string | 10 characters | Quoted ASCII label string, 10 characters or fewer. |
Sets the position of the specified digital channel. This command is only valid for the MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| position | integer | - | Integer position of the specified channel. |
Sets the display size of the digital channels. The setting applies to all digital channels and is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel index in NR1 format. |
| value | enum | SMALl | MEDium | LARGe | Display size for the digital channels. |
Sets the logic threshold value for all channels in the same pod as the specified digital channel. The threshold is used for triggering and for displaying digital data as high or low; valid only on MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel number in NR1 format. |
| value | enum | CMOS | ECL | TTL | Logic threshold preset or a user-defined threshold value with optional suffix. |
Turns annotation on or off for annotation item <n>. When on, the annotation appears in the upper left corner of the oscilloscope display.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 1 | ON | 0 | OFF | Sets the annotation state. |
| n | integer | 1 - 10 | Annotation index in NR1 format. |
Sets the background of annotation <n>. The query returns the specified annotation background mode.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 10 | Annotation index. |
| mode | enum | OPAQue | INVerted | TRANsparent | Background mode for the annotation. |
Sets the annotation color for annotation n. You can choose white, red, or colors that match analog channels, digital channels, math waveforms, reference waveforms, or markers.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 10 | Annotation number in NR1 format. |
| color | enum | CH1 | CH2 | CH3 | CH4 | DIG | MATH | REF | MARKer | WHITe | RED | Annotation color. |
Specifies the annotation text for display annotation n. The text can be up to 254 characters and may be cleared by sending an empty quoted string.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII annotation text, up to 254 characters. |
Sets the annotation's horizontal X1 position. The query returns the annotation's horizontal X1 position.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 800 - width of annotation | Horizontal X1 position in NR1 format. |
Sets the annotation's vertical Y1 position. The query returns the annotation's vertical Y1 position.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 480 - height of annotation | Vertical Y1 position in NR1 format. |
| n | integer | 1 - 10 | Annotation number in NR1 format. |
Turns the display's backlight off or on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether the display backlight is off or on. |
Clears the display and resets all associated measurements. If the oscilloscope is stopped, all currently displayed data is erased; if it is running, active-channel and function data is erased and new data appears on the next acquisition.
Reads screen image data. The image can be returned as 24-bit BMP, 8-bit BMP8bit, or 24-bit PNG in color or grayscale, and the data is returned as an IEEE-488.2 # binary block.
| Name | Type | Values | Description |
|---|---|---|---|
| formatopt | enum | BMP | BMP8bit | PNG | Selects the image format. |
| paletteopt | enum | COLor | GRAYscale | Selects color or grayscale output. |
:DISPlay:DATA? BMP, COLOR
Turns graticule (grid) axis labels on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether graticule axis labels are enabled or disabled. |
Sets the graticule (grid) intensity. The query returns the current graticule intensity setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 100 | Graticule intensity level in NR1 format. |
Sets the graticule (grid) type. When TV trigger mode is selected and at least one displayed channel is scaled at 140 mV/div, the available grid types are FULL, MVOLt, and IRE.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | FULL | MVOLt | IRE | Graticule grid type to select. |
Sets the waveform intensity, equivalent to adjusting the front panel Intensity knob. The query returns the waveform intensity setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 100 | Waveform intensity setting. |
Turns the analog and digital channel labels on and off.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Turns labels on or off. |
myScope.WriteString ":DISPlay:LABel ON" ' Turn on labels.
Adds labels to the display label list in alphabetical order. Labels are stored as an ordered list of up to 75 newline-separated labels, each up to 32 characters; duplicate labels are not added.
| Name | Type | Values | Description |
|---|---|---|---|
| binary block data | block | - | An ordered list of labels separated by newline characters. |
:DISPlay:LABList <binary block data> :DISPlay:LABList?
Changes the front panel softkey menu or turns it off. When off, channel setup information is displayed instead.
| Name | Type | Values | Description |
|---|---|---|---|
| menu | enum | MASK | MEASure | SEGMented | LISTer | POWer | OFF | Front panel softkey menu to display, or OFF to turn it off. |
Removes all user messages that are currently on screen.
Sets the display persistence setting. Use MINimum for zero persistence, INFinite for infinite persistence, or a time value for variable persistence.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MINimum | INFinite | Persistence setting to apply. |
| time | real | 100E-3 - 60E0 | Persistence time in seconds for variable persistence. |
Erases all persistence data from the display, leaving the data from the last acquisition. If the oscilloscope is running, the display begins accumulating waveform and persistence data again.
:DISPlay:PERSistence:CLEar
Specifies which sidebar dialog to display on the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| sidebar | enum | SUMMary | CURSors | MEASurements | DVM | NAVigate | CONTrols | EVENts | COUNter | HISTogram | Sidebar dialog to display. |
Enables or disables transparent mode for dialog box backgrounds in the front panel graphical user interface. The query returns the current transparent setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | ON | Sets the transparent mode state. |
Turns vector display on or off. When vectors are turned on, the oscilloscope displays lines connecting sampled data points.
| Name | Type | Values | Description |
|---|---|---|---|
| vectors | enum | 1 | ON | 0 | OFF | Sets the vector display state. |
:DISPlay:VECTors <vectors> :DISPlay:VECTors?
Turns vectors on and off so the oscilloscope displays lines connecting sampled data points when enabled. This is an obsolete compatibility command; use :DISPlay:VECTors instead.
| Name | Type | Values | Description |
|---|---|---|---|
| connect | enum | 1 | ON | 0 | OFF | Turns vector display on or off. |
Returns a list of digital channel numbers in screen order from top to bottom, separated by commas. Busing is displayed as digital channels with no separator; NONE indicates that a channel is turned off.
:DISPLAY:ORDER 0,10
Turns the DVM Auto Range capability on or off for the selected digital voltmeter source channel when that channel is not used in oscilloscope triggering. When enabled, the channel’s vertical scale, vertical position, and trigger level are automatically adjusted; when disabled, they can be adjusted normally.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Selects whether Auto Range is off or on. |
Returns the displayed 3-digit DVM value based on the current mode. After DVM analysis is enabled, the query may briefly return +9.9E+37 until good results are available.
Turns the digital voltmeter (DVM) analysis feature on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Sets whether DVM analysis is enabled or disabled. |
Sets the digital voltmeter (DVM) mode. The query returns the selected DVM mode.
| Name | Type | Values | Description |
|---|---|---|---|
| dvm_mode | enum | ACRMs | DC | DCRMs | Selects the DVM display mode. |
Sets the selected analog channel on which DVM measurements are made. The selected channel does not have to be on in order for DVM measurements to be made.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Selects the DVM input source channel. |
:DVM:SOURce CHANnel1 :DVM:SOURce CHANnel2
Sets the external trigger low-pass filter setting. The command is provided for product compatibility; the only legal value is 0 or OFF. The query returns the current setting, which is always 0.
| Name | Type | Values | Description |
|---|---|---|---|
| bwlimit | enum | 0 | OFF | Selects the external trigger bandwidth limit setting. |
Specifies the probe attenuation factor for the external trigger. It does not change the actual input sensitivity, only the reference constants used for display scaling and trigger levels.
| Name | Type | Values | Description |
|---|---|---|---|
| attenuation | real | 0.1 - 1000 | Probe attenuation ratio in NR3 format. |
Sets the full-scale range for the external trigger. This command is provided for product compatibility; with 1:1 probe attenuation, the range is either 1.6 V or 8 V and is automatically recalculated when external trigger probe attenuation changes.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | V | Vertical full-scale range value in NR3 format. |
| suffixopt | enum | V | mV | 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 will reflect the selected units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units for the external trigger probe. |
:EXTernal:UNITs VOLT :EXTernal:UNITs?
Controls the external probe sense mode for compatibility with previous oscilloscopes. The setting is internally determined; if the sent mode matches the oscilloscope's setting the command is accepted, otherwise a setting conflict error is generated.
| Name | Type | Values | Description |
|---|---|---|---|
| pmode value | enum | AUTo | MANual | Probe sense mode value. |
Returns the frequency response analysis data. The data is returned as comma-separated columns for each step in the sweep: Frequency (Hz), Amplitude (Vpp), Gain (dB), and Phase (°).
| Name | Type | Values | Description |
|---|---|---|---|
| modeopt | enum | SWEep | SINGle | Selects whether to get data from a sweep or single-frequency analysis. |
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 | Selects whether FRA is enabled or disabled. |
Selects between normal swept frequency response analysis and analysis at a single frequency. The query returns the current frequency mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | SWEep | SINGle | Selects the frequency analysis mode. |
Sets the single frequency value for frequency response analysis. The setting is displayed on a log-scale Bode plot and may use the minimum frequency of 20 Hz or decade values.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 20 - 10000000 | Single frequency value to set. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency unit suffix. |
:FRANalysis:FREQuency:SINGle <value>[suffix] :FRANalysis:FREQuency:SINGle?
Sets the frequency sweep start value for frequency response analysis. The start value can be chosen from decade values, with an optional frequency suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 20 - 10000000 | Frequency sweep start value. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency suffix. |
Sets the frequency sweep stop value for frequency response analysis. The log-scale Bode plot allows decade values in addition to the maximum frequency of 20 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 100 - 20000000 | Frequency sweep stop value to set. |
| suffixopt | enum | Hz | kHz | MHz | Optional unit suffix for the stop value. |
:FRANalysis:FREQuency:STOP <value>[suffix] :FRANalysis:FREQuency:STOP?
Specifies the number of points per decade in the frequency response analysis. The query returns the current points-per-decade setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 10 - 100 | Points per decade setting. |
Performs the Frequency Response Analysis, sweeping a sine wave across a frequency range while measuring the DUT input and output. The alias :FRANalysis:APPLy is also valid for this command.
Specifies the analog input channel that probes the input voltage to the DUT in the frequency response analysis. The query returns the currently selected input channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Analog input channel to use as the probing input. |
Selects the analog input channel that probes the DUT output voltage for frequency response analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Analog input channel used to probe the output voltage. |
Specifies the number of points in the frequency response analysis. Depending on the number of points specified and the number of decades in the frequency range, this command can also change the :FRANalysis:PPDecade setting.
| Name | Type | Values | Description |
|---|---|---|---|
| points | integer | 1 - 1000 | Number of points in the frequency response analysis. |
Specifies whether to include gain, phase, both, or neither in the frequency response analysis results. The setting affects the front-panel graphical user interface and saved analysis data.
| Name | Type | Values | Description |
|---|---|---|---|
| selection | enum | NONE | ALL | GAIN | PHASe | Selects which response data to include; the command also allows a second value of GAIN or PHASe to specify a gain/phase combination. |
Selects the expected output load impedance for the waveform generator. This setting lets the display show correct amplitude and offset levels for the selected load.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
Sets the waveform generator's output sine wave amplitude. When amplitude profile is on, the optional range specifies the initial ramp amplitude at the frequency setting. The query returns the currently specified waveform generator amplitude, or the initial ramp amplitude for the specified frequency when amplitude profile is on.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Amplitude in volts, in NR3 format. |
| rangeopt | enum | F20HZ | F100HZ | F1KHZ | F10KHZ | F100KHZ | F1MHZ | F10MHZ | F20MHZ | Frequency range used when amplitude profile setting is on. |
Enables or disables voltage profile mode, which allows amplitude ramping within different decades. The query returns the current voltage profile setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns voltage profile off or on. |
Sets the number of waveforms to be averaged together for math function <m>. The number of averages can be set from 2 to 65536 in increments of powers of 2.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 65536 | Number of waveforms to average together. |
Selects the clock signal source for the Chart Logic Bus State operation. The query returns the currently selected source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | DIGital<d> | Clock signal source. |
Specifies the clock signal edge for the Chart Logic Bus State operation. The query returns the current clock edge setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | Clock signal edge setting. |
Specifies the value associated with each increment in Chart Logic Bus data. The query returns that value.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Selects the math function number in NR1 format. |
| value | numeric | - | Value per bus code in NR3 format. |
Sets the value associated with Chart Logic Bus data equal to zero. The query returns the value associated with data equal to zero.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Function index in NR1 format. |
| value | real | - | Value at bus code = 0 in NR3 format. |
Specifies the vertical units for the Chart Logic Bus operations. The query returns the current Chart Logic Bus vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | NONE | Vertical units for the Chart Logic Bus operations. |
Clears the number of evaluated waveforms when :FUNCtion<m>:OPERation is AVERage, MAXHold, or MINHold.
Turns the selected math function display on or off. When ON is selected, the function operates as specified by the other :FUNCtion<m> commands; if one math function is turned on, any previously displayed math function is turned off.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Math function index in NR1 format. |
| display | enum | 1 | ON | 0 | OFF | Turns the function display on or off. |
Returns the FFT Bin Size setting for the selected function. The query applies to :FUNCtion<m>[:FFT] and reports the bin size in Hz.
Sets the center frequency for FFT when FFT is selected. The query returns the current center frequency in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | -25 GHz - 25 GHz | The current center frequency to set, in NR3 format. |
Specifies the maximum number of points the FFT detector decimates to, which is also the number of buckets used before detection-type reduction is applied. The minimum is 640 points and the maximum is 64K, the measurement record limit.
| Name | Type | Values | Description |
|---|---|---|---|
| number_of_buckets | integer | 640 - 64K | Maximum number of FFT detector points to decimate to. |
Sets the FFT detector decimation type for function m. The detector type controls how sampled FFT points are reduced into detector points.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | OFF | SAMPle | PPOSitive | PNEGative | NORMal | AVERage | FFT detector type to use. |
Sets the start frequency for the FFT math function's displayed range. The start frequency can also be set with the FFT center and span commands.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | The start frequency in NR3 format. |
Sets the FFT math function's displayed stop frequency. The FFT displayed range can also be set with :FUNCtion<m>[:FFT]:CENTer and :FUNCtion<m>[:FFT]:SPAN.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | The stop frequency. |
Specifies whether FFT is performed on the Main time base window or the ZOOM window when zoomed time base is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - 4 | Function number in NR1 format. |
| gating | enum | NONE | ZOOM | Selects the time base window used for the FFT. |
Sets the reference point for calculating the FFT Phase function to either the trigger point or the beginning of the displayed waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| ref_point | enum | TRIGger | DISPlay | Reference point used for FFT Phase calculations. |
Queries the Resolution Bandwidth setting for the FFT.
Selects the FFT readout type for the specified function and readout number. The query returns the current readout selection.
| Name | Type | Values | Description |
|---|---|---|---|
| readout_type | enum | SRATe | BSIZe | RBWidth | Selects which FFT readout type to display. |
| m | integer | 1 - 4 | Function number in NR1 format. |
| n | integer | 1 - 2 | Readout number in NR1 format; 2 is valid only on oscilloscopes that have the dedicated FFT function. |
Sets the frequency span of the display when FFT is selected. The query returns the current frequency span in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Math function index in NR1 format. |
| span | real | 1 Hz - 100 GHz | Current frequency span in NR3 format. |
Returns the Sample Rate setting for the FFT.
Specifies the FFT vertical units for a math function. For FFT magnitude, DECibel corresponds to logarithmic display and VRMS to linear display; for FFT phase, DEGRees or RADians are available.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Math function index in NR1 format. |
| units | enum | DECibel | VRMS | DEGRees | RADians | FFT vertical units. DECibel and VRMS apply to FFT magnitude; DEGRees and RADians apply to FFT phase. |
Selects the FFT windowing transform used for :FUNCtion<m>:FFT. The available windows are rectangular, Hanning, Flat top, Blackman-Harris, and Bartlett; HANNing is the default window.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Math function index in NR1 format. |
| window | enum | RECTangular | HANNing | FLATtop | BHARris | BARTlett | FFT windowing transform to apply. |
Sets the center frequency of the band-pass filter. The query returns the band-pass filter's center frequency setting.
| Name | Type | Values | Description |
|---|---|---|---|
| center_freq | real | - | Center frequency of the band-pass filter in NR3 format. |
Sets the frequency width of the band-pass filter. The width specifies the filter's -3 dB cutoff frequencies (center frequency minus half the width and center frequency plus half the width).
| Name | Type | Values | Description |
|---|---|---|---|
| freq_width | real | - | Frequency width of the band-pass filter in NR3 format. |
Sets the high-pass filter's -3 dB cutoff frequency. The high-pass filter is a single-pole high pass filter.
| Name | Type | Values | Description |
|---|---|---|---|
| 3dB_freq | real | - | -3dB cutoff frequency value in NR3 format. |
Sets the low-pass filter's -3 dB cutoff frequency for function m. The filter is a 4th order Bessel-Thompson filter.
| Name | Type | Values | Description |
|---|---|---|---|
| 3dB_freq | real | - | -3 dB cutoff frequency value in NR3 format. |
Sets the Initial Condition of the Integrate math function waveform. ON vertically centers the waveform on the screen; OFF starts it at the zero-level reference on the left side of the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Initial Condition setting for the Integrate math function waveform. |
Sets the DC offset correction factor for the integrate math waveform input signal. This correction lets you level a ramped waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| input_offset | real | - | DC offset correction in NR3 format. |
Specifies the 'A' value in the Ax + B operation for the selected math function. The query returns the gain value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The 'A' value in Ax + B, in NR3 format. |
Specifies the B value in the Ax + B operation for function m. The query returns the offset value.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Function index in NR1 format. |
| value | real | - | B value in the Ax + B operation, in NR3 format. |
Sets the voltage or vertical value represented at center screen for the selected function. The offset is automatically clipped to the nearest legal value if it is set outside the allowed range.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | The value at center screen in NR3 format. |
Sets the desired waveform math operator, transform, filter, or visualization for function <m>. The query returns the current operation for the selected function.
| Name | Type | Values | Description |
|---|---|---|---|
| operation | enum | ADD | SUBTract | MULTiply | DIVide | DIFF | INTegrate | FFT | FFTPhase | SQRT | MAGNify | ABSolute | SQUare | LN | LOG | EXP | TEN | LOWPass | HIGHpass | BANDpass | AVERage | SMOoth | ENVelope | LINear | MAXimum | MINimum | PEAK | MAXHold | MINHold | TRENd | BTIMing | BSTate | SERChart | Desired math operation or visualization to apply to function <m>. |
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 |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Selects the math function index in NR1 format. |
| range | real | - | Full-scale vertical axis value in NR3 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; the command is equivalent to :FUNCtion<m>:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Selects the math function number in NR1 format. |
| level | real | - | Current reference level in NR3 format. |
Sets the vertical scale, or units per division, of the selected math function. Legal values depend on the selected function.
| Name | Type | Values | Description |
|---|---|---|---|
| scale value | real | - | Vertical units per division value in NR3 format. |
| suffixopt | enum | V | dB | Optional unit suffix for the scale value. |
Sets the serial bus source for the Chart Serial Signal math function. The query returns the current serial bus source.
| Name | Type | Values | Description |
|---|---|---|---|
| serialbus | enum | SBUS<n> | Serial bus source to select. |
Sets the time mode for the Chart Serial Signal math function. MAIN plots signal data per acquisition on the normal time scale; ROLL plots data at the right side of the display and rolls it across the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MAIN | ROLL | Time mode to use for the Chart Serial Signal math function. |
Sets the full-scale time range for the Chart Serial Signal math function when ROLL serial chart time mode is selected. The time range controls the width across the display for the charted serial signal waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Math function index in NR1 format. |
| range_value | real | - | Time range value in NR3 format. |
Sets the time offset for the Chart Serial Signal math function when ROLL serial chart time mode is selected. The query returns the current time offset setting.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Math function index in NR1 format. |
| offset | real | - | Time offset value in NR3 format. |
Sets the number of smoothing points used when :FUNCtion<m>:OPERation is SMOoth. The number of points must be an odd integer, from 3 up to half of the measurement record or precision analysis record.
| Name | Type | Values | Description |
|---|---|---|---|
| points | integer | 3 - half of the measurement record or precision analysis record | Odd integer number of smoothing points to use. |
Selects the first source for the operator math functions, or the single source for transform, filter, or visualization functions. For TRENd, the command is invalid because TRENd operates on a measurement rather than a source waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | FUNCtion<c> | MATH<c> | WMEMory<r> | BUS<b> | Source to use for the function operation. |
Specifies the second source for math operator functions that have two sources. It is not used for transform, filter, or visualization functions except in the measurement trend visualization case.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | WMEMory<r> | NONE | Second source for the math operation. |
Selects the measurement whose trend is shown in the math waveform. The query returns the selected installed measurement, or NONE if no measurements are installed.
| Name | Type | Values | Description |
|---|---|---|---|
| MEAS<n> | integer | 1 - 10 | Specifies the location of the installed measurement whose trend you want to analyze. |
Controls what part of the display area is printed. Currently, the only legal choice is SCReen.
| Name | Type | Values | Description |
|---|---|---|---|
| area | enum | SCReen | Selects the display area to print. |
Sets the active printer. The query returns the name of the active printer.
| Name | Type | Values | Description |
|---|---|---|---|
| active_printer | numeric | - | Selects the active printer by list index or printer 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 between the screen image and factors of a hardcopy dump. |
Controls whether the graticule colors are inverted or not.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted. |
Sets the hardcopy layout mode. The query returns the selected hardcopy layout mode.
| Name | Type | Values | Description |
|---|---|---|---|
| layout | enum | LANDscape | PORTrait | Hardcopy layout mode to set. |
Sets the address for a network printer slot. The address is the server/computer name and printer share name in \\server\share format.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | Quoted ASCII string specifying the network printer address. |
Applies the network printer settings and makes the printer connection.
Sets the Windows network domain name for hardcopy network printing. The domain name setting is common to both network printer slots.
| Name | Type | Values | Description |
|---|---|---|---|
| domain | string | - | Quoted ASCII string specifying the Windows network domain name. |
Sets the password for the specified Windows network domain and user name. The password setting is common for both network printer slots.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | Quoted ASCII string password. |
Selects the network printer slot used for the address and apply commands. There are two network printer slots to choose from.
| Name | Type | Values | Description |
|---|---|---|---|
| slot | enum | NET0 | NET1 | Network printer slot to select. |
Sets the user name used when connecting to the Windows network domain. The setting is common for both network printer slots.
| Name | Type | Values | Description |
|---|---|---|---|
| username | string | - | Quoted ASCII string user name. |
Sets the hardcopy palette color. The COLOR option is not available when connected to laser printers.
| Name | Type | Values | Description |
|---|---|---|---|
| palette | enum | COLor | GRAYscale | NONE | Hardcopy palette color to use. |
Returns a list of available printers. The list can be empty.
Starts a print job.
Sets the hardcopy destination. This 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; the manual recommends :SAVE:FILename and :RECall:FILename instead.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string filename to use for hardcopy output. |
Controls whether grayscaling is performed in the hardcopy dump. This command is obsolete and provided for compatibility; the manual recommends :HARDcopy:PALette instead.
| Name | Type | Values | Description |
|---|---|---|---|
| gray | enum | OFF | 0 | ON | 1 | Selects whether grayscaling is enabled for the hardcopy dump. |
Controls whether the graticule colors are inverted. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:INKSaver instead.
| 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. If the correct driver for the selected printer can be identified, it will be selected and cannot be changed.
| Name | Type | Values | Description |
|---|---|---|---|
| driver | enum | AP2Xxx | AP21xx | AP2560 | AP25 | DJ350 | DJ35 | DJ6xx | DJ630 | DJ63 | DJ6Special | DJ6Photo | DJ8Special | DJ8xx | DJ9Vip | OJPRokx50 | DJ9xx | GVIP | DJ55xx | PS470 | PS47 | PS100 | PS10 | CLASer | MLASer | LJFastraster | POSTscript | Printer driver to use for the selected printer. |
Reads and returns screen image data in the selected format. The query supports an optional format selector and returns the image as IEEE-488.2 # binary block data.
| Name | Type | Values | Description |
|---|---|---|---|
| formatopt | enum | PNG | BMP | BMP8bit | Selects the screen image data format to return. |
Sets the screen image data format. The setting persists through power cycling but is reset to PNG by *RST.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | PNG | BMP | BMP8bit | Specifies the screen image data format. |
Sets the orientation of the histogram when :HISTogram:MODE is WAVeform. In MEASurement mode, histograms are always displayed horizontally.
| Name | Type | Values | Description |
|---|---|---|---|
| axis | enum | VERTical | HORizontal | Specifies the histogram orientation. |
:HISTogram:AXIS <axis> :HISTogram:AXIS?
Turns the histogram display on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns the histogram display on or off. |
Selects which installed measurement slot is used for histogram analysis when :HISTogram:MODE is MEASurement. The query returns the currently selected measurement location.
| Name | Type | Values | Description |
|---|---|---|---|
| MEAS<n> | integer | 1 - 10 | Specifies the location of the installed measurement to analyze. |
Selects the histogram mode or disables histogram analysis. The query returns the currently set histogram mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | WAVeform | MEASurement | Selects the histogram type or turns histogram analysis off. |
Zeros the histogram counters.
Specifies the number of divisions the histogram bar graph should use. For horizontal histograms, whole and half divisions from 1 to 4 are allowed; for vertical histograms, whole and half divisions from 1 to 5 are allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| size | real | 1.0 - 5.0 | Number of divisions for the histogram bar graph. |
Selects either a waveform histogram (horizontal or vertical) or a measurement histogram. The query returns the currently selected histogram type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | VERTical | HORizontal | MEASurement | Histogram type to select. |
Sets the histogram limits window's bottom boundary when :HISTogram:MODE is WAVeform. The units are the same as the input waveform's vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | - | Bottom value in NR3 format. |
Sets the histogram limits window's left boundary when :HISTogram:MODE is WAVeform. The units are the same as the input waveform's horizontal units.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | - | Left value in NR3 format. |
Sets the histogram limits window's right boundary when :HISTogram:MODE is WAVeform. The units are the same as the input waveform's horizontal units.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | - | Right value in NR3 format. |
Specifies the waveform used as the histogram source when :HISTogram:MODE is WAVeform. The query returns the currently specified waveform histogram source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | CGRade | Selects the waveform source for the histogram window. |
Sets the top boundary of the histogram limits window when :HISTogram:MODE is WAVeform. The value uses the input waveform's vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | - | Top value in NR3 format. |
Returns the lister data.
Configures which serial buses are displayed in the Lister, or turns the Lister display off. When set to ALL, decode information for different buses is interleaved in time.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | SBUS1 | ON | 1 | SBUS2 | 2 | ALL | Selects the Lister display setting. |
Selects whether the time value for a Lister row is relative to the trigger or the previous Lister row. The query returns the current Lister time reference setting.
| Name | Type | Values | Description |
|---|---|---|---|
| time_ref | enum | TRIGger | PREVious | Selects the Lister time reference basis. |
For the measurement selected by :LTESt:MEASurement, sets the upper and lower limits to the last measurement result plus or minus a percent margin.
Sets the upper and lower limits for all measurements whose limits are being tested to the last measurement result plus or minus a percent margin. It performs the :LTESt:COPY operation on all measurements whose limits are being tested.
Sets the percent margin used when copying measurement results to upper and lower limits for the measurement selected by :LTESt:MEASurement. The query returns the current percent margin setting.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | - | Copy margin percent in NR1 format. |
Turns the measurement limit test feature on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables the measurement limit test feature. |
Sets the fail condition for the active measurement currently selected by :LTESt:MEASurement. When a measurement failure is detected by the limit test, the specified fail action conditions are executed.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | INSide | OUTSide | Fail condition for the measurement; INSide fails when results are within the limit parameters, OUTSide fails when results exceed the limit parameters. |
Sets the lower test limit for the active measurement currently selected by :LTESt:MEASurement. The query returns the current lower limit setting.
| Name | Type | Values | Description |
|---|---|---|---|
| lower_value | real | - | Lower test limit value in NR3 format. |
Selects the measurement source used by :LTESt:FAIL, :LTESt:LLIMit, :LTESt:ULIMit, and :LTESt:TEST. The selected source is one of the active measurements by number.
| Name | Type | Values | Description |
|---|---|---|---|
| MEAS<n> | integer | 1 - 10 | Number of the installed measurement to select. |
Queries the measurement results for a selected installed measurement. When :LTESt:TEST is ON, it returns the failed minimum value, failed maximum value, and total number of measurements made; when :LTESt:TEST is OFF, it returns nothing.
| Name | Type | Values | Description |
|---|---|---|---|
| MEAS<n>opt | integer | 1 - 10 | Selects the installed measurement number. |
Enables or disables the limit test "stop on failure" option. When ON, the oscilloscope acquisition system stops once a limit failure is detected.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the stop-on-failure state. |
Enables or disables the limit test function for the active measurement selected by :LTESt:MEASurement. When any measurement has its limit test enabled, the overall Limit Test feature is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables the limit test function. |
:LTESt:TEST {{0 | OFF} | {1 | ON}}
:LTESt:TEST?Sets the upper test limit for the active measurement selected by :LTESt:MEASurement. The query returns the current upper limit setting.
| Name | Type | Values | Description |
|---|---|---|---|
| upper_value | real | - | Upper test limit value in NR3 format. |
Returns the cursor ∆Y/∆X value. X cursor units are set by :MARKer:XUNits; if the front-panel cursors are off, the marker position values are not defined.
Sets the cursors mode. OFF removes cursor information from the display; MANual, MEASurement, WAVeform, BINary, and HEX select the corresponding cursor behaviors.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | MEASurement | MANual | WAVeform | BINary | HEX | Selects the cursor mode. |
Specifies whether the X1 cursor is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the X1 cursor display state. |
Sets the X1 cursor position to the specified NR3 value and switches :MARKer:MODE to MANual if it is not currently WAVeform. X cursor units are controlled by :MARKer:XUNits.
| 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 position value. |
Sets the source for the cursors. If the marker mode is not currently WAVeform, sending this command puts the cursors in MANual mode and also sets the other marker pair source in some cases.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | HISTogram | Source for the cursors. |
Specifies whether the X2 cursor is displayed. The query returns the X2 cursor display setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns X2 cursor display off or on. |
Sets the X2 cursor position to the specified value. The command sets :MARKer:MODE to MANual if it is not currently set to WAVeform.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | X2 cursor position in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Hz | kHz | MHz | Optional suffix for the cursor position. |
Sets the source for the cursors. If the marker mode is not currently WAVeform, sending this command puts the cursors in MANual mode and sets both marker pairs to the same source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | HISTogram | Source 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 cursor units set by :MARKer:XUNits.
Sets the X cursor 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 | X cursor units to use for time, frequency, phase, or ratio measurements. |
Sets the current X1 and X2 reference locations for marker X units when :MARKer:XUNits is DEGRees or PERCent. After the locations are set, :MARKer:X1Position, :MARKer:X2Position, and :MARKer:XDELta inputs and outputs are relative to those locations.
Specifies whether the Y1 cursor is displayed. The query returns the Y1 cursor display setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the Y1 cursor display state. |
Sets the Y1 cursor position in NR3 format. If :MARKer:MODE is not currently WAVeform, the command sets :MARKer:MODE to MANual and updates the cursor position; Y cursor units are set by :MARKer:YUNits.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | Y1 cursor position in NR3 format. |
| suffixopt | enum | mV | V | dB | Optional unit suffix for the position value. |
Specifies whether the Y2 cursor is displayed. The query returns the Y2 cursor display setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Whether the Y2 cursor is displayed. |
Sets the Y2 cursor position in NR3 format and can optionally include a unit suffix of mV, V, or dB. If :MARKer:MODE is not currently WAVeform, the command sets :MARKer:MODE to MANual and updates the Y2 cursor position; Y positions cannot be set when mode is WAVeform.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | Y2 cursor position in NR3 format. |
| suffixopt | enum | mV | V | dB | Optional unit suffix for the cursor position. |
Returns the value difference between the current Y1 and Y2 cursor positions. Ydelta is calculated as the value at Y2 cursor minus the value at Y1 cursor.
Sets the Y cursors units. BASE uses the units associated with the cursor source; PERCent is for ratio measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | BASE | PERCent | 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. Afterward, :MARKer:Y1Position, :MARKer:Y2Position, and :MARKer:YDELta use those locations as their reference.
Installs a Snapshot All measurement on the screen.
Installs an area measurement on screen. The optional interval selects either an integral number of cycles or the full screen; if omitted, DISPlay is implied.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval to use. |
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source waveform. |
Installs a screen measurement and starts a bit rate measurement. If an optional source is specified, the currently specified source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Selects the measurement source. |
Installs a burst width measurement on screen. If no source is specified, the current measurement source is used; the command is not available when the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use for the burst width measurement. |
Clears all selected measurements and markers from the screen.
Installs a screen measurement and starts a counter measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | DIGital<d> | CHANnel<n> | EXTernal | Source used for the counter measurement. |
Sets up the definition for delay or threshold measurements by specifying delay edge specifications or threshold values. Changing these values may affect the results of other measurement commands.
| Name | Type | Values | Description |
|---|---|---|---|
| meas_spec | enum | DELay | THResholds | Selects whether the command defines delay measurement setup or threshold setup. |
| sourceopt | channel_list | - | Specifies the measurement source channel, function, math trace, or reference waveform. |
:MEASure:DEFine DELay,<delay spec>[,<source>] :MEASure:DEFine THResholds,<threshold spec>[,<source>] :MEASure:DEFine? <meas_spec>[,<source>]
Places the instrument in continuous measurement mode and starts a delay measurement between two sources. The delay is measured as the time difference between the selected edges, with edge selection controlled by <edge_select_mode> and :MEASure:DELay:DEFine settings.
| Name | Type | Values | Description |
|---|---|---|---|
| edge_select_modeopt | enum | MANual | AUTO | Selects how source edges are chosen for the delay measurement. |
| source1opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d> | First measurement source. |
| source2opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d> | Second measurement source. |
Defines the slope directions, edge numbers, and edge position parameters used for delay measurements. The query returns the currently specified delay measurement parameter definitions.
| Name | Type | Values | Description |
|---|---|---|---|
| source1_edge_slope | enum | RISing | FALLing | Slope direction for source 1. |
| source1_edge_number | integer | 0 - 1000 | Edge number for source 1, in NR1 format. |
| source1_edge_threshold | enum | LOWer | MIDDle | UPPer | Edge threshold position for source 1. |
| source2_edge_slope | enum | RISing | FALLing | Slope direction for source 2. |
| source2_edge_number | integer | 0 - 1000 | Edge number for source 2, in NR1 format. |
| source2_edge_threshold | enum | LOWer | MIDDle | UPPer | Edge threshold position for source 2. |
Installs a dual charge measurement on screen. If optional source parameters are provided, the currently specified sources are modified; the interval defaults to DISPlay when omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval: an integral number of cycles or the full screen. |
| source1opt | channel_list | - | First measurement source, specified as CHANnel<n> with an N2820A probe connected. |
| source2opt | channel_list | - | Second measurement source, specified as CHANnel<n> with an N2820A probe connected. |
Installs a screen measurement and starts a vertical amplitude measurement for the selected waveform. If optional source parameters are specified, the currently specified source(s) are modified.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | First measurement source channel, requiring an N2820A probe connected. |
| source2opt | channel_list | - | Second measurement source channel, requiring an N2820A probe connected. |
Installs a screen measurement and starts an average value measurement using the specified interval and optional sources. If no interval is specified, DISPlay is implied.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Specifies the measurement interval as either an integral number of cycles or the full screen. |
| source1opt | channel_list | - | First source channel, using CHANnel<n> with an N2820A probe connected. |
| source2opt | channel_list | - | Second source channel, using CHANnel<n> with an N2820A probe connected. |
Installs a screen measurement and starts a waveform base value measurement. If optional source parameters are specified, the currently specified source(s) are modified.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | First source channel for the measurement. |
| source2opt | channel_list | - | Second source channel for the measurement. |
Installs a screen measurement and starts a vertical peak-to-peak measurement. If optional source parameters are specified, the currently specified sources are modified.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | First measurement source, a CHANnel<n> input with an N2820A probe connected. |
| source2opt | channel_list | - | Second measurement source, a CHANnel<n> input with an N2820A probe connected. |
Installs a screen measurement and starts an RMS value measurement using the specified interval, type, and optional probe sources. On query, it measures and outputs the RMS value measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Specifies the measurement interval as either an integral number of cycles or the full screen. |
| typeopt | enum | AC | DC | Selects AC RMS or DC RMS measurement. |
| source1opt | discrete | - | Optional first measurement source channel. |
| source2opt | discrete | - | Optional second measurement source channel. |
Installs a screen measurement and starts a positive duty cycle measurement on the current :MEASure:SOURce. If an optional source is provided, it changes the current source first.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Selects the signal source for the duty cycle measurement. Valid sources include digital channels, analog channels, math functions, and reference waveforms. |
Installs a screen measurement and starts a fall-time measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use. |
Installs an FFT analysis Adjacent Channel Power Ratio (ACPR) measurement on screen. The query returns the measured ACPR value.
| Name | Type | Values | Description |
|---|---|---|---|
| chan_width | real | Hz | Width of the main range and sideband channels. |
| chan_spacing | real | Hz | Spacing between the main range and sideband channels. |
| chan | enum | CENTer | HIGH<sb> | LOW<sb> | Selects the sideband to measure. |
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | FFT waveform source used for the measurement. |
Installs an FFT analysis Channel Power measurement on screen. The FFT center frequency defines the measurement center, and the FFT span defines the frequency range.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | FFT waveform source used for the measurement. |
Installs an FFT analysis Occupied Bandwidth measurement on screen. Occupied bandwidth measures the frequency range containing a specified percentage of the total spectral power.
| Name | Type | Values | Description |
|---|---|---|---|
| percentage | real | - | Percent of spectral power occupied bandwidth is measured for, in NR3 format. |
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | FFT waveform source. |
Installs an FFT analysis Total Harmonic Distortion measurement on screen. The measurement can track the fundamental frequency automatically or manually, and the source must be an FFT waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| tracking | enum | AUTO | MANual | Selects automatic or manual tracking of the fundamental frequency and harmonics. |
| fundamental_freqopt | real | - | Fundamental frequency in NR3 format; required when tracking is MANual. |
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | Selects the FFT waveform source. |
Installs a screen frequency measurement and starts measuring frequency. If an optional source is specified, the current source is modified. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use. |
Returns the width of each bin (bucket) in the histogram.
Returns the sum of all hits in all bins (buckets) in the histogram.
Returns the percentage of histogram hits that lie within ±1 standard deviation of the mean.
Returns the percentage of histogram hits that lie within ±2 standard deviations of the mean.
Returns the percentage of histogram hits that lie within ±3 standard deviations of the mean.
Returns the value corresponding to the maximum bin that has any hits.
Returns the mean value of the histogram.
Returns the median value of the histogram.
Returns the value corresponding to the minimum bin that has any hits.
Returns the mode value of the histogram.
Returns the maximum number of hits in any single bin.
Returns the delta between the Max and Min values from the histogram. The query returns the delta value between max bin and min bin in NR3 format.
Returns the standard deviation of the histogram values.
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 | channel_list | - | Specifies the measurement source; it may be a digital channel, analog channel, math function, or waveform memory. |
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<m> | MATH<m> | 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<m> | MATH<m> | WMEMory<r> | DIGital<d> | Measurement source to use. |
Installs a screen measurement and starts a negative pulse width measurement. If the optional source is not specified, the current source is modified. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Measurement source: digital channels, one analog channel, one math function, or one reference waveform. |
Installs a screen measurement and starts an overshoot measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the measurement source. |
Installs a rising edge count measurement on screen. If the optional source parameter is not specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source. |
Installs a screen measurement and starts a period measurement. If the optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use for the period measurement. |
Starts a continuous phase measurement using the specified source or sources. The query measures and returns the phase between the specified sources, calculated from delay and period measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | - | - | First measurement source. |
| source2opt | - | - | 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 | - | - | Measurement source: CHANnel<n>, FUNCtion<m>, MATH<m>, WMEMory<r>, or digital channels (DIGital<d> on MSO models). |
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<m> | MATH<m> | WMEMory<r> | Selects the measurement source. |
:MEASure:PREShoot [<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 | channel_list | - | Measurement source to use for the pulse width measurement. |
Returns the results of the continuously displayed measurements. The response is a comma-separated list of measurement results, with values duplicated for each continuous measurement in top-to-bottom display order when more than one is running.
Installs a screen rise-time measurement and starts measuring rise time. If an optional source is specified, the current source is modified. The command is not available when the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use. |
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<m> | MATH<m> | WMEMory<r> | Selects the waveform source for the measurement. |
Enables markers for tracking measurements on the display. The query returns the current marker state, and can return OFF when :MARKer:MODE selects a mode other than MEASurement.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 0 | OFF | 1 | ON | Turns measurement markers off or on. |
Installs a slew rate measurement on the oscilloscope screen for the specified source and optional edge slope. If no source is given, the current :MEASure:SOURce setting is used; if no slope is given, a rising edge is measured.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Measurement source waveform. |
| slopeopt | enum | RISing | FALLing | EITHer | Edge slope to measure. |
Sets the default measurement source selections used by MEASure subsystem commands when sources are not explicitly set. If a source is specified for any measurement, the current source is changed to that value.
| Name | Type | Values | Description |
|---|---|---|---|
| source1 | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Primary measurement source. |
| source2opt | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Secondary measurement source; used only for delay and phase measurements. |
:MEASure:SOURce CHANnel1
Sets the statistics mode used by the :MEASure:RESults? query. ON means all statistics are on.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | ON | 1 | CURRent | MINimum | MAXimum | MEAN | STDDev | COUNt | Selects the statistics type returned by :MEASure:RESults?. |
Disables or enables the display of the measurement statistics.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | State of the measurement statistics display. |
Updates the statistics once by incrementing the count by one using the current measurement values. It is only allowed when the oscilloscope is stopped and quick measurements are on; it is allowed in segmented acquisition mode.
Specifies the maximum number of values used when calculating measurement statistics. The query returns the current measurement statistics max count setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | INFinite | Maximum number of values used when calculating measurement statistics, or infinite. |
| count | integer | 2 - 2000 | Maximum number of values used when calculating measurement statistics. |
Resets the measurement statistics, zeroing the counts. The measurement statistics configuration is not deleted.
Disables or enables relative standard deviations (standard deviation/mean) in the measurement statistics.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns relative standard deviations off or on. |
Installs a screen measurement for the time of the specified edge transition relative to the trigger edge. The optional slope selects rising, falling, or either edges, and the optional source selects the signal to search.
| Name | Type | Values | Description |
|---|---|---|---|
| slopeopt | enum | RISing | FALLing | EITHer | Specifies whether to look for rising, falling, or either edges. |
| occurrence | integer | - | Specifies the Nth edge to identify; 0 means the edge closest to the timebase reference. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the signal source to search for the edge transition. |
:MEASure:TEDGe? [<slope>,]<occurrence>[,<source>] myScope.WriteString ":MEASURE:TEDGE? +1, CHAN1" myScope.WriteString ":MEASURE:TEDGE? +2, CHAN1"
Searches the displayed signal for a specified vertical value crossing and returns the time interval from the trigger event to the requested occurrence. An optional source can be specified to modify the current source; the query is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The vertical value that the waveform must cross. |
| slopeopt | real | - | Direction of the waveform crossing; plus sign for rising edge, minus sign for falling edge. |
| occurrence | integer | - | The transition number to be reported. |
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Source signal to use for the measurement. |
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<m> | MATH<m> | WMEMory<r> | Selects the waveform source for the measurement. |
Installs a screen measurement and starts an average value measurement. The optional interval selects either an integral number of cycles or the full screen; if omitted, DISPlay is implied. If a source is supplied, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval to use. |
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to modify. |
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<m> | MATH<m> | WMEMory<r> | Selects the waveform source for the measurement. |
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<m> | MATH<m> | WMEMory<r> | Selects the waveform source for the measurement. |
:MEASure:VMAX [<source>] :MEASure:VMAX? [<source>]
Installs a screen measurement and starts a minimum vertical value measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Measurement source to use for the VMIN 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 | discrete | - | Selects the measurement source: channel, function, math, or memory waveform. |
Installs a ratio measurement on screen using the AC RMS values of two specified sources, expressed in dB. If <interval> is omitted, DISPlay is implied; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval: an integral number of cycles or the full screen. |
| source1opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | First measurement source. |
| source2opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Second measurement source. |
Installs a screen measurement and starts an RMS value measurement. Optional interval, type, and source can be specified; if omitted, DISPlay and DC are implied.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval: either an integral number of cycles or the full screen. |
| typeopt | enum | AC | DC | Selects AC RMS or DC RMS measurement. |
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use or modify. |
Installs a screen measurement and starts a waveform top value measurement. The source cannot be FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | - | - | Measurement source: CHANnel<n>, FUNCtion<m>, or MATH<m>. |
Selects which display window is used for measurements: Main, Zoom, Auto, or Gate. The query returns the current measurement window setting.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | MAIN | ZOOM | AUTO | GATE | Chooses the measurement window location. |
Installs a screen measurement and starts an X-at-Max-Y measurement on the selected window. If an optional source is specified, the current source is modified. This command is an alias for :MEASure:TMAX.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the measurement source. |
Installs a screen measurement and starts an X-at-Min-Y measurement on the selected window. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the measurement source; specifying it also modifies the current source. |
Installs a screen measurement of the vertical value at a specified horizontal value on the selected source. For FFT waveforms, the horizontal location is a frequency value instead of time.
| Name | Type | Values | Description |
|---|---|---|---|
| horiz_location | real | s | Time from trigger in seconds; for FFT waveforms, a frequency value instead of time. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use. |
Installs a power phase angle measurement on screen. The query returns the measured power phase angle in degrees.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | Channel probing voltage source. |
| source2opt | channel_list | - | Channel probing current source. |
Installs an apparent power measurement on screen using the specified voltage and current sources. The query returns the measured apparent power.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | Channel probing voltage source. |
| source2opt | channel_list | - | Channel probing current source. |
Installs a power loss per cycle measurement on screen. The measurement operates in zoom mode and uses a counter measurement on the switching signal voltage.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | discrete | FUNCtion<m> | MATH<m> | Primary source waveform, typically a math multiply waveform or another waveform representing power (voltage * current). |
| source2opt | discrete | CHANnel<n> | Secondary source channel. |
Installs a crest factor measurement on screen. The optional source selects the channel or math function used for the measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Channel probing current or voltage source for the crest factor measurement. |
Installs an efficiency measurement on screen. Before using it, the input voltage, input current, output voltage, and output current channels must be specified and automated signals setup must be performed.
Installs an energy loss measurement on screen. The <source> parameter is typically a math multiply waveform or other waveform representing power, and can also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | - | - | Measurement source waveform. |
Installs a power factor measurement on the screen. The source1 parameter is the channel probing voltage and source2 is the channel probing current; these sources can also be set with :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | Channel probing voltage source. |
| source2opt | channel_list | - | Channel probing current source. |
Installs an input power measurement on screen. Before using it, the input voltage, input current, output voltage, and output current channels must be specified and automated signals setup must be performed.
Installs an off time measurement on screen. Off time is the time from when the input AC voltage last falls to 10% of its maximum amplitude to when the output DC voltage last falls to 10% of its maximum amplitude.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | AC voltage source channel. |
| source2opt | channel_list | - | DC voltage source channel. |
Installs an "on time" measurement on the screen using one or two channel sources. The first source is the AC voltage and the second source is the DC voltage; these sources can also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | AC Voltage source channel. |
| source2opt | channel_list | - | DC Voltage source channel. |
:MEASure:ONTime [<source1>][,<source2>] :MEASure:ONTime? [<source1>][,<source2>]
Installs an output power measurement on screen. Before using it, the required voltage/current signal sources must be specified and automated signals setup performed.
Installs a peak current measurement on screen. The source parameter selects the channel probing the current and may also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Source probing the current. |
Installs a power loss measurement on screen. The source is typically a math multiply waveform or another waveform representing power, and can also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source waveform. |
Installs a power Rds(on) measurement on screen. The query returns the measured Rds(on) value.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | First measurement source. |
| source2opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Second measurement source. |
Installs a reactive power measurement on screen. The optional source arguments specify the channel probing voltage and current; they can also be set using :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | - | Channel probing voltage source. |
| source2opt | channel_list | - | Channel probing current source. |
Installs a real power measurement on screen. The optional <source> can be a channel, function, or math waveform and may also be set with :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | Selects the waveform source used for the real power measurement. |
Installs an output ripple measurement on screen. The query returns the measured output ripple, defined as Vmax - Vmin.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Channel, function, math, or waveform memory source used for the ripple measurement. |
Installs a transient response time measurement on screen. The source can also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Channel, function, math, or waveform memory source used to probe the output voltage. |
Installs a power Vce(sat) measurement on screen. The optional source selects the channel, function, math, or waveform memory used for the measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use. |
Sets the lower measurement threshold value. The value and the upper threshold represent absolute values when thresholds are ABSolute and percentage when thresholds are PERCent, as defined by :MEASure:DEFine THResholds. This command is obsolete and provided for backward compatibility.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | Lower measurement threshold value. |
Clears all selected measurements and markers from the screen. This command is obsolete and provided for backward compatibility; use :MEASure:CLEar instead.
Returns the time difference between the Tstart marker (X1 cursor) and the Tstop marker (X2 cursor). This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:XDELta instead.
Selects the thresholds used when making time measurements. This command is obsolete and provided for backward compatibility; use :MEASure:DEFine THResholds instead.
| Name | Type | Values | Description |
|---|---|---|---|
| thresholds | enum | T1090 | T2080 | VOLTage | Threshold set to use for time measurements. |
Installs a screen measurement and starts an X-at-Max-Y measurement on the selected waveform. If an optional source is specified, the current source is modified. This command is obsolete and provided for backward compatibility; use :MEASure:XMAX instead.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion | MATH | Selects the measurement source waveform. |
Installs a screen measurement and starts an X-at-Min-Y measurement on the selected waveform. If an optional source is specified, it modifies the current source. This command is obsolete and provided for backward compatibility; use :MEASure:XMIN instead.
| 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 trigger time. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:X1Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | s | Time at the start marker in seconds. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time unit suffix. |
Moves the stop marker (X2 cursor) to the specified time with respect to trigger time. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:X2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | s | Time at the stop marker in seconds. |
| suffixopt | enum | s | ms | us | ns | ps | Optional unit suffix for the time value. |
Queries the time interval from the trigger event to the specified voltage crossing of the displayed waveform. The command is obsolete and provided for backward compatibility; if the crossing cannot be found, the oscilloscope returns +9.9E+37.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The voltage level that the waveform must cross. |
| slopeopt | integer | - | Direction of the waveform; rising edge is indicated by + and falling edge by -. |
| occurrence | integer | - | The transition number to be reported. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | Selects the source to be measured. |
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). It is an obsolete compatibility command; use :MARKer:YDELta instead.
Moves the vertical marker (Y1 cursor) to the specified value corresponding to the selected source. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:Y1Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| vstart_argument | real | V | Value for vertical marker 1. |
Moves the vertical marker 2 (Y2 cursor) to the specified value for the selected source. This command is obsolete and provided for compatibility; use :MARKer:Y2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| vstop_argument | real | - | Value for the Y2 cursor. |
:MEASure:VSTOp <vstop_argument> :MEASure:VSTOp?
Returns the vertical value at a specified horizontal location on the specified source. The horizontal value must be on screen; when it is a time value, it is referenced to the trigger event. If the source is an FFT waveform, the <vtime_argument> is a frequency value instead of a time value.
| Name | Type | Values | Description |
|---|---|---|---|
| vtime_argument | real | s | Time from trigger in seconds. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source; optional if the source is to be modified. |
Specifies which channel(s) are included in the mask test. ON includes all displayed analog channels; OFF includes only the selected source channel.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Selects whether all displayed analog channels or only the selected source channel are included in the mask test. |
Automatically constructs a mask around the currently selected channel using the tolerance parameters defined by :MTESt:AMASk:XDELta, :MTESt:AMASk:YDELta, and :MTESt:AMASk:UNITs. The mask only covers the portion of the waveform visible on the display.
Selects the source used to interpret :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta when :MTESt:AMASk:UNITs is set to CURRent. It is the same as :MTESt:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel source to use for mask parameter interpretation. |
Alters how the mask test subsystem interprets tolerance parameters for automasking. The setting can be current channel units or screen divisions, and changing it does not convert existing XDELta and YDELta values.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | CURRent | DIVisions | Selects the measurement units used by the mask test subsystem. |
Sets the X-direction tolerance used by the automasking feature. The absolute tolerance is added and subtracted from waveform horizontal values to determine mask boundaries, and its interpretation depends on :MTESt:AMASk:UNITs.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | X delta value in NR3 format. |
Sets the vertical tolerance around the waveform for the automasking feature. The tolerance is interpreted according to the current :MTESt:AMASk:UNITs setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Y delta value in NR3 format. |
Returns the total number of failed waveforms in the current mask test run. The count is for all regions and all waveforms collected on the specified channel, or on the currently specified source channel if no channel is given.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | channel_list | - | Optional channel number selecting which analog channel to use. |
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 IEEE 488.2 binary block data. The query returns a mask in binary block data format using the IEEE 488.2 # format.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | block | - | Binary block data for the mask. |
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. ON locks a mask to the source so it is redrawn as the source scaling or position changes; OFF makes the mask static.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask lock on or off. |
Sets the mask test termination condition. The condition can be forever, Sigma level, time, or a fixed number of waveforms; related setting values are configured by the associated :MTESt:RMODe:SIGMa, :MTESt:RMODe:TIME, and :MTESt:RMODe:WAVeforms commands.
| Name | Type | Values | Description |
|---|---|---|---|
| rmode | enum | FORever | SIGMa | TIME | WAVeforms | Termination condition for the mask test. |
Sets measuring only mask failures on or off. When ON, measurements and measurement statistics run only on waveforms that contain a mask violation; passing waveforms do not affect measurements and measurement statistics.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask-failure measurement mode on or off. |
Sets printing of mask failures on or off. Setting :MTESt:RMODe:FACTion:PRINt ON automatically sets :MTESt:RMODe:FACTion:SAVE OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables printing on mask failures. |
Sets mask-failure saving on or off. Setting :MTESt:RMODe:FACTion:SAVE ON automatically sets :MTESt:RMODe:FACTion:PRINt OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask-failure saving on or off. |
Sets whether stopping on a mask failure is enabled or disabled. When ON and a mask violation is detected, the mask test and acquisition system are stopped.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask-failure stop on or off. |
Sets the test sigma level used when :MTESt:RMODe is set to SIGMa. The value indirectly specifies how many waveforms must be tested to reach the sigma level.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.1 - 9.3 | Test sigma level. |
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 a mask test to run, expressed in NR3 format. |
Sets the number of waveform acquisitions that are mask tested when :MTESt:RMODe is set to WAVeforms. The query returns the number of waveforms currently set.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 2,000,000,000 | Number of waveforms in NR1 format. |
Enables or disables Bind 1 & 0 Levels control, or the Bind -1 & 0 Levels control for inverted masks. When enabled, the paired level controls track each other; when disabled, adjusting either control changes the mask height.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns the bind control on or off. |
Defines where X=0 in the base coordinate system used for mask testing. The query returns the current X1 coordinate setting.
| Name | Type | Values | Description |
|---|---|---|---|
| x1_value | real | s | X1 value in NR3 format. |
Defines the position of the X2 marker with respect to the X1 marker in the mask test coordinate system. Changing ΔX also shifts normalized X vertices so they stay in the same locations relative to X1 and ΔX.
| Name | Type | Values | Description |
|---|---|---|---|
| xdelta_value | real | - | X delta value in NR3 format; a time value specifying the distance of the X2 marker with respect to the X1 marker. |
:MTESt:SCALe:XDELta <xdelta_value> :MTESt:SCALe:XDELta?
Defines where Y=0 in the coordinate system for mask testing. The Y1 value is a voltage value specifying the point at which Y=0.
| Name | Type | Values | Description |
|---|---|---|---|
| y1_value | real | V | Y1 value in NR3 format. |
Defines the Y2 marker in the coordinate system for mask testing. The Y2 value specifies the location of the Y2 marker as a voltage value.
| Name | Type | Values | Description |
|---|---|---|---|
| y2_value | real | V | Y2 value in NR3 format. |
Selects the channel configured by the commands contained in a mask file when it is loaded. The query returns the channel configured by the current mask file.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Channel to select, where n is 1 to the number of analog channels in NR1 format. |
Returns the mask title. The title is displayed in the mask test dialog box and mask test tab when a mask file is loaded.
Enables or disables averaging for the oscilloscope. When ON, the instrument acquires multiple data values for each time bucket and averages them; when OFF, averaging is disabled.
| 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 acquisition is complete for that bucket. This 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 of the mask file, up to 254 characters including the path name. |
Sets the mask test termination condition. Choices are FORever, TIME with a seconds value, or WAVeforms with a waveform count. This command is obsolete and provided for backward compatibility; use :MTESt:RMODe instead.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FORever | TIME | WAVeforms | Termination condition for the mask test. |
| secondsopt | real | 1 - 86400 | Amount of time in seconds before the mask test terminates. |
| wfm_countopt | 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 criterion for mask tests. When a mask violation is detected, the mask test and acquisition system are stopped; this command is obsolete and provided for backward compatibility.
| 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 with previous oscilloscopes.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | 1 - # analog channels | Channel to use as the trigger. |
Turns displaying of the specified POD channel group on or off. This command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Controls whether the specified group of channels is displayed. |
| n | integer | 1 - 2 | Selects the channel group, where 1 corresponds to POD1 (D0-D7) and 2 corresponds to POD2 (D8-D15). |
Sets the digital channel size for the pods on the display. The setting applies to all pods; setting pod 1 also sets pod 2 to the same size. Valid only for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | SMALl | MEDium | LARGe | Specifies the pod digital channel size. |
Sets the threshold for the specified POD channel group. The threshold is used for triggering and for displaying digital data as high or low.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | CMOS | ECL | TTL | <user defined value> | Threshold preset or user-defined threshold value. |
| suffixopt | enum | V | mV | uV | Unit suffix for a user-defined threshold value. |
myScope.WriteString ":POD1:THRESHOLD CMOS" myScope.WriteString ":POD2:THRESHOLD 2.0"
Returns the Control Loop Response (Bode) power analysis settings.
:POW:CLR:SOUR:INP CHAN1;OUTP CHAN2;:POW:CLR:FREQ:STAR +100E+00; STOP +20.000000E+06;:POW:CLR:WGEN:VOLT +200.0E-03;LOAD FIFT
Performs the control loop response (Bode) analysis to help determine the margin of a control loop. The analysis sweeps an input sine wave from low to high frequency while measuring input and output RMS voltages using two oscilloscope channels.
Returns data from the Control Loop Response (Bode) power analysis. The optional SWEep or SINGle qualifier selects sweep or single-frequency analysis data; if omitted, sweep data is returned by default.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | SWEep | SINGle | Selects whether to get the data from sweep or single-frequency analysis. |
After Control Loop Response (Bode) power analysis has been performed, this query returns the gain margin in dB. It returns +9.9E+37 if the value cannot be calculated from the last sweep (for example, if there are no crossover points).
Returns the 0° phase crossover frequency in Hz after Control Loop Response (Bode) power analysis has been performed. If the value cannot be calculated from the last sweep, the query returns +9.9E+37.
Returns the phase margin in degrees after Control Loop Response (Bode) power analysis has been performed. It returns +9.9E+37 if the value cannot be calculated from the last sweep (for example, if there are no crossover points).
Returns the 0 dB gain crossover frequency in Hz after Control Loop Response (Bode) power analysis has been performed. If the value cannot be calculated from the last sweep, the query returns +9.9E+37.
Sets whether the analysis is performed by sweeping through a range of frequencies or at a single frequency. The query returns the current frequency mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SWEep | SINGle | Selects sweep or single-frequency analysis mode. |
Sets the single frequency value for control loop response analysis. The value is shown on a log-scale Bode plot and can be selected from listed decade values, with 20 Hz as the minimum frequency.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 20 - 10000000 | Single frequency value to set. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency unit suffix. |
Sets the frequency sweep start value for control loop response analysis. The sweep start can be selected from decade values in addition to the minimum frequency of 20 Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 20 - 10000000 | Frequency sweep start value. |
Sets the frequency sweep stop value for control loop response analysis. The stop value can be one of the listed decade values up to 20 MHz, with an optional Hz, kHz, or MHz suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 100 - 20000000 | Frequency sweep stop value. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency unit suffix. |
Selects the number of frequency test points per decade in the logarithmic scale. The query returns the current points-per-decade setting.
| Name | Type | Values | Description |
|---|---|---|---|
| pts | integer | 10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100 | Points per decade setting. |
Selects the oscilloscope channel that is probing the power supply input.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel selection in the form CHANnel<n>, where n is 1 to the number of analog channels. |
Selects the oscilloscope channel that is probing the power supply output. The query returns the current channel selection.
| Name | Type | Values | Description |
|---|---|---|---|
| source | string | - | Channel to use for probing the power supply output. |
:POWer:CLResponse:SOURce:OUTPut <source> :POWer:CLResponse:SOURce:OUTPut?
Specifies whether to include gain, phase, both, or neither in the control loop response analysis results. The setting affects the front-panel GUI as well as saved analysis data.
| Name | Type | Values | Description |
|---|---|---|---|
| selection | enum | NONE | ALL | GAIN | PHASe | Selects which control loop response data types are included; the optional second item restricts the selection list to gain or phase. |
Sets the waveform generator expected output load impedance. The setting lets the waveform generator display correct amplitude and offset levels for the expected load.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
Sets the waveform generator output amplitude. With an optional range, it sets the initial ramp amplitude for that frequency range when the amplitude profile is enabled; without the range, it sets the amplitude used when the profile is disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Amplitude in volts in NR3 format. |
| rangeopt | enum | F20HZ | F100HZ | F1KHZ | F10KHZ | F100KHZ | F1MHZ | F10MHZ | F20MHZ | Frequency range for which to set the amplitude. |
Enables or disables the ability to set initial waveform generator ramp amplitudes for each frequency range.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns amplitude profiling off or on. |
Launches the auto deskew process on the oscilloscope. The deskew values are saved until a factory default or secure erase is performed.
Applies the efficiency power analysis. Efficiency analysis tests the overall efficiency of the power supply by measuring output power over input power.
Specifies the type of power being converted from the input to the output, which affects how efficiency is measured.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | DCDC | DCAC | ACDC | ACAC | Specifies the power-conversion type. |
Enables or disables power analysis. The query returns whether power analysis is enabled or disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the power analysis enable state. |
Applies the current harmonics analysis. The command is used with Current Harmonics analysis to test a switching power supply's current harmonics against IEC61000-3-2 pre-compliance standards.
Returns the power harmonics results table data.
Specifies how to display the current harmonics analysis results. The query returns the current display setting.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | TABLe | BAR | OFF | Display mode for harmonics analysis results. |
Returns the current harmonics analysis fail count. Non spec values (harmonics values not specified by the selected standard) are not counted.
Specifies the line frequency setting for the current harmonics analysis. The query returns the current line frequency setting.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | enum | F50 | F60 | F400 | AUTO | Line frequency setting to use for harmonics analysis. |
Returns the power factor for IEC 61000-3-2 Standard Class C power factor value.
Specifies whether the Real Power value used for the current-per-watt measurement is measured by the oscilloscope or defined by the user when Class D harmonics analysis is selected. Use the related USER command to enter the user-defined value.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | MEASured | USER | Selects the Real Power source. |
Specifies the user-defined Real Power value used in the current-per-watt measurement when Class D is selected as the current harmonics analysis standard and a user-defined Real Power value is in use. The query returns that user-defined Real Power value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 1.0 - 600.0 | User-defined Real Power value. |
Returns the current harmonics analysis run iteration count. Non-spec values (harmonics values not specified by the selected standard) are not counted.
Selects the IEC 61000-3-2 standard used for current harmonics compliance testing. The query returns the currently set standard.
| Name | Type | Values | Description |
|---|---|---|---|
| class | enum | A | B | C | D | IEC 61000-3-2 standard class to use for harmonics compliance testing. |
Returns the overall pass/fail status of the current harmonics analysis.
Returns the Total Harmonics Distortion (THD) results of the current harmonics analysis.
Applies the inrush current analysis. The analysis measures the peak inrush current of the power supply when the power supply is first turned on.
Exits (stops) the inrush current power analysis. It is equivalent to pressing the Exit softkey on the oscilloscope front panel during the analysis.
Goes to the next step of the inrush current analysis. It is equivalent to pressing the Next softkey on the oscilloscope front panel when prompted during the analysis.
Specifies the type of power being converted from the input. The setting affects how measurements are made and is used in the Inrush Current and Turn On/Turn Off tests.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | DC | AC | Selects the input power type. |
Applies the selected modulation analysis type. The command is used for modulation analysis of a control pulse signal to a switching device and its trending characteristics.
Selects either the voltage source or the current source as the source for the modulation analysis. The query returns the selected source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | V | I | Selects the modulation analysis source. |
Selects the type of measurement used in modulation analysis. The query returns the current modulation type setting.
| Name | Type | Values | Description |
|---|---|---|---|
| modulation | enum | VAVerage | ACRMs | VRATio | PERiod | FREQuency | PWIDith | NWIDth | DUTYcycle | RISetime | FALLtime | Modulation measurement type to use. |
Applies the selected turn on/off analysis test. It is associated with the :POWer:ONOFf:TEST setting.
Exits (stops) the turn on time/turn off time analysis. It is equivalent to pressing the Exit softkey on the oscilloscope front panel during the analysis.
Advances the turn on/turn off analysis to the next step. It is equivalent to pressing the Next softkey on the oscilloscope front panel when prompted during the analysis.
Selects whether turn-on or turn-off analysis is performed. ON measures the time taken for the output voltage to come up after the input voltage is applied; OFF measures the time taken for the output voltage to turn off after the input voltage is removed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects the test type. |
Specifies the input and output thresholds used in the Turn On/Turn Off analysis. The query returns the current input and output threshold settings for the selected analysis type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | ON | OFF | Selects the turn-on or turn-off analysis type. |
| input_thr | real | 0 - 100 | Input threshold as a percent from 0 to 100 in NR1 format. |
| output_thr | real | 0 - 100 | Output threshold as a percent from 0 to 100 in NR1 format. |
Returns the Power Supply Rejection Ratio (PSRR) power analysis settings.
:POW:PSRR:SOUR:INP CHAN1;OUTP CHAN2;:POW:PSRR:FREQ:STAR +100E+00; STOP +20.000000E+06;:POW:PSRR:WGEN:VOLT +200.0E-03;LOAD FIFT
Applies the power supply rejection ratio (PSRR) analysis. The analysis uses the oscilloscope waveform generator to sweep frequency and measure the AC RMS ratio of input over output.
Returns PSRR power analysis data as comma-separated values suitable for spreadsheet analysis. The optional SWEep or SINGle qualifier selects sweep or single-frequency analysis data; if omitted, sweep data is returned by default.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | SWEep | SINGle | Selects whether the data comes from a sweep or single-frequency analysis. |
Sets the end sweep frequency value for PSRR measurements. The value may be selected from decade values up to 20 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 10 - 20000000 | End sweep frequency value. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency suffix. |
Sets the start sweep frequency value for PSRR measurements. The measurement is displayed on a log scale, so only decade values are allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1 - 10000000 | Start sweep frequency value. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency suffix. |
Specifies whether the PSRR frequency analysis is performed by sweeping through a range of frequencies or at a single frequency.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SWEep | SINGle | Selects sweep mode or single-frequency mode. |
Sets the single frequency value for PSRR measurements. The measurement is displayed on a log scale, so decade values can be selected.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 1 - 10000000 | Single frequency value to set. |
Selects the number of frequency test points per decade in the log scale.
| Name | Type | Values | Description |
|---|---|---|---|
| pts | integer | 10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100 | Points per decade setting. |
Selects the oscilloscope channel used to probe the power supply input. The query returns the current channel selection.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel to use as the power supply input probe. |
Selects the oscilloscope channel that is probing the power supply output.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | 1 - (# analog channels) | Channel to use as the power supply output probe channel. |
Specifies whether gain (PSRR) data is included in the power supply rejection ratio analysis results. It affects the front-panel plot and table as well as saved analysis data.
| Name | Type | Values | Description |
|---|---|---|---|
| selection | enum | NONE | GAIN | Selects whether PSRR gain data is included. |
Sets the waveform generator expected output load impedance. The setting is used so the generator can display correct amplitude and offset levels for the expected load.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
Sets the waveform generator output amplitude(s). With the waveform generator amplitude profile enabled, you can set an initial ramp amplitude for each frequency range; without a <range> parameter, it sets the amplitude used when the profile is disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Amplitude in volts in NR3 format. |
| rangeopt | enum | F20HZ | F100HZ | F1KHZ | F10KHZ | F100KHZ | F1MHZ | F10MHZ | F20MHZ | Frequency range for which to set the waveform generator amplitude. |
Enables or disables the ability to set initial waveform generator ramp amplitudes for each frequency range. With amplitude profiling, lower amplitudes can be used where the DUT is sensitive to distortion and higher amplitudes where it is less sensitive.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables voltage profiling. |
Applies the selected power quality analysis type. The command is used to view AC input line power quality measurements such as power factor, apparent power, true power, reactive power, crest factor, and phase angle.
Applies the output ripple analysis.
Performs automated oscilloscope setup for the signals in the specified type of power analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| analysis | enum | HARMonics | EFFiciency | RIPPle | MODulation | QUALity | SLEW | SWITch | RDSVce | Specifies the type of power analysis to set up automatically. |
Specifies the number of cycles to include in the current harmonics analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 100 | Number of cycles to include in the harmonics analysis. |
Specifies the number of cycles to include in the power quality analysis. The query returns the number of cycles currently set.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 100 | Number of cycles to include in the power quality analysis. |
Sets the duration of the efficiency analysis. The query returns the set duration time value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Duration value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | Optional time suffix. |
Sets the duration of the modulation analysis. The query returns the set duration time value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Duration value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | Optional unit suffix for the duration value. |
Specifies the duration of the turn off analysis. The query returns the set duration time value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Duration value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | Optional time suffix. |
Specifies the duration of the turn on analysis. The query returns the set duration time value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | NR3-formatted duration value. |
| suffixopt | enum | s | ms | us | ns | Optional time suffix. |
Specifies the duration of the output ripple analysis. The query returns the set duration time value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Duration value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | Optional time unit suffix. |
Specifies the duration of the transient response analysis. The query returns the set duration time value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Duration value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | Optional time suffix. |
Specifies the expected inrush current amplitude, which is used to set the vertical scale of the channel probing current.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Expected current value in NR3 format. |
| suffixopt | enum | A | mA | Unit suffix for the current value. |
Specifies the percent overshoot of the output voltage. The value is used to determine the settling band for transient response and to adjust the oscilloscope vertical scale.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | integer | - | Percent of overshoot value in NR1 format. |
Specifies the maximum expected input voltage used to set the vertical scale for inrush current analysis. For DC input, it defines the maximum DC input voltage amplitude and may be negative; for AC input, it defines the maximum peak-to-peak input voltage and must be positive.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Maximum expected input voltage in NR3 format. |
Sets the maximum expected input voltage used for turn-off analysis and vertical scaling. The value may be negative for DC, but only positive for AC, and a suffix of V or mV may be used.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Maximum expected input voltage in NR3 format. |
Specifies the maximum expected input voltage used to set the vertical scale of the channel probing voltage for turn-on analysis. For DC input, it defines the maximum DC input voltage amplitude and may be negative; for AC input, it defines the maximum peak-to-peak input voltage and must be positive.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Maximum expected input voltage in NR3 format. |
Specifies the expected steady-state output DC voltage of the power supply for turn-off analysis. The query returns the expected steady-state voltage setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Expected steady-state output voltage value in NR3 format. |
Specifies the expected steady-state output DC voltage of the power supply for turn-on analysis. The query returns the expected steady-state voltage setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Expected steady state output voltage value in NR3 format. |
:POWer:SIGNals:VSTeady:ONOFf:ON <value>[suffix] :POWer:SIGNals:VSTeady:ONOFf:ON?
Sets the expected steady-state output DC voltage of the power supply for transient response analysis. The value is used with overshoot percentage to define the settling band and adjust the oscilloscope vertical scale.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Expected steady-state output voltage in NR3 format. |
| suffixopt | enum | V | mV | Voltage unit suffix. |
Specifies the first, and perhaps second, current source channel to be used in the power analysis. The query returns the current source channel setting.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Current source channel to use for power analysis. |
Specifies the first, and perhaps second, voltage source channel to be used in the power analysis. The query returns the current voltage source channel setting.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Voltage source channel, specified as CHANnel<n> where n is in NR1 format from 1 to the number of analog channels. |
Applies the slew rate analysis.
Selects either the voltage source or the current source as the source for the slew rate analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | V | I | Selects the source used for slew rate analysis. |
Applies the switching loss analysis using the current conduction calculation method, V reference, and I reference settings.
Specifies the conduction calculation method used for the Power waveform. The query returns the current conduction method.
| Name | Type | Values | Description |
|---|---|---|---|
| conduction | enum | WAVeform | RDS | VCE | Selects the conduction calculation method. |
Specifies the current switching level used for the start of switching edges. The value is set as a percentage of the maximum switch current and can be used to ignore noise floors or null offset.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | % | Percent value in NR1 format. |
Sets the Rds(on) value used when the RDS conduction calculation method is selected. The query returns the Rds(on) value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | OHM | Rds(on) value in NR3 format. |
Specifies the Vce(sat) value used when the VCE conduction calculation method is chosen. The query returns the current Vce(sat) value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Vce(sat) value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix. |
Specifies the voltage switching level for the switching edges as a percentage of the maximum switch voltage. You can adjust the value to ignore noise floors; it sets the threshold used to determine the switching edges.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | % | Percent value in NR1 format. |
Applies the transient analysis using the initial current and new current settings.
Exits (stops) the transient analysis. It is equivalent to pressing the Exit softkey on the oscilloscope front panel during the analysis.
Specifies the initial load current value used as a reference and to trigger the oscilloscope. The query returns the initial load current value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | A | Initial current value in NR3 format. |
Specifies the new load current value used as a reference and to trigger the oscilloscope. The query returns the new load current value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | New current value in NR3 format. |
| suffixopt | enum | A | mA | Units for the current value. |
Goes to the next step of the transient analysis. This is equivalent to pressing the Next softkey on the oscilloscope front panel when prompted during the analysis.
Recalls an arbitrary waveform from an internal location or a CSV file. The optional column selects which CSV column to load, and the optional wavegen ID chooses which waveform generator to load into.
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification, either an internal location or a file name. |
| columnopt | integer | 1 | CSV column number to load; column numbering starts from 1. |
| wavegen_idopt | enum | WGEN1 | WGEN2 | Specifies which waveform generator to recall the arbitrary waveform into. |
Loads a CAN DBC symbolic data file into the oscilloscope. If a file extension is provided in <file_name>, it must be ".dbc".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII file name of the CAN DBC symbolic data file to load. |
| serialbusopt | string | - | Specifies which serial decode waveform the CAN symbolic data is loaded for. |
Specifies the source filename for RECall operations. The filename is stored as a base name only, without path information or an extension.
| Name | Type | Values | Description |
|---|---|---|---|
| base_name | string | - | Quoted ASCII string specifying the file base name. |
Loads a LIN description file (LDF) symbolic data file into the oscilloscope. If a file extension is provided, it must be ".ldf"; the optional serial bus selects which serial decode waveform the LIN symbolic data is loaded for.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string naming the LDF file to load. |
| serialbusopt | channel_list | - | Specifies which serial decode waveform the LIN symbolic data will be loaded for. |
Recalls a mask from a specified file or internal location. If a file name is used, any file extension must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification to recall, either an internal location or a quoted ASCII file name. |
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 recall working directory. |
Recalls an oscilloscope setup. An optional file specification may be an internal location or a quoted ASCII file name; if a file extension is provided, it must be ".scp".
| 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. The waveform can be recalled from a specified quoted ASCII file name or from binary block data in IEEE 488.2 # format; if a file name includes an extension, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Reference waveform number in NR1 format. |
| file_nameopt | string | - | Quoted ASCII file name to recall from. |
| dataopt | block | - | Binary block data in IEEE 488.2 # format. |
Saves the current arbitrary waveform to an internal location or to a file on a USB storage device. The <wavegen_id> parameter specifies which waveform generator to save the waveform from.
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | Internal location or file name to save to. |
| wavegen_idopt | enum | WGEN1 | WGEN2 | Specifies which waveform generator to save the arbitrary waveform from. |
Saves USB 2.0 signal quality test results to a file. If a file extension is provided in <file_name>, it must be ".html".
| Name | Type | Values | Description |
|---|---|---|---|
| <file_name>opt | string | - | Quoted ASCII string naming the output file. |
Specifies the source for SAVE 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 used as the file base name. |
Saves an image to a file. Set :SAVE:IMAGe:FORMat before using this command; if a file extension is supplied and it does not match the expected format, the format may be changed to match a valid image extension.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string file name for the saved image. |
Controls whether the oscilloscope factors are output along with the image. Factors are written to a separate file with the same path and base name but with the ".txt" extension.
| Name | Type | Values | Description |
|---|---|---|---|
| factors | enum | OFF | 0 | ON | 1 | Enables or disables output of oscilloscope factors with the image. |
Sets the image format type for save operations. The query returns the selected image format type; when NONE is returned, a waveform data file format is currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BMP | BMP24bit | BMP8bit | PNG | Image format to use for saved images. |
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 the graticule colors are inverted. |
Sets the image palette color. The query returns the selected image palette color.
| Name | Type | Values | Description |
|---|---|---|---|
| palette | enum | COLor | GRAYscale | Image palette color to set. |
Saves the Lister display data to a file. If a file extension is provided in <file_name>, it must be ".csv".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the file name. |
Saves a mask. An optional file specification can be a quoted ASCII file name or an internal location 0-3; if a file extension is provided, it must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification to save the mask to, either an internal location or a quoted ASCII file name. |
Saves multi-channel waveform data to a file for use with the N8900A Infiniium Offline oscilloscope analysis software. If a file extension is included in <file_name>, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| <file_name>opt | string | - | Quoted ASCII string specifying the file name. |
Saves the power measurement application's current harmonics analysis results to a file. If a file extension is provided in <file_name>, it must be ".csv".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the file name to save to. |
Sets the present working directory for save operations. The query returns the currently set working directory for save operations.
| Name | Type | Values | Description |
|---|---|---|---|
| path_name | string | - | Quoted ASCII string specifying the working directory path. |
Saves analysis results to a comma-separated values (*.csv) file on a USB storage device. Use the :SAVE:RESults:FORMat commands to specify which analysis types are saved; if multiple types are selected, their results are written to the same file separated by a blank line.
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | Destination file specification; the manual notes the file name is a quoted ASCII string. |
Specifies whether cursor values will be included when analysis results are saved. The corresponding query returns whether cursor values will be included.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns cursor values saved with analysis results off or on. |
Specifies whether histogram statistics are included when analysis results are saved with :SAVE:RESults:[STARt]. The saved results are written to the same file as other selected analysis results, separated by a blank line.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns histogram statistics saving off or on. |
Specifies whether mask statistics are included when analysis results are saved. The corresponding query returns whether mask statistics will be included.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables inclusion of mask statistics in saved analysis results. |
Specifies whether measurement results are included when analysis results are saved. The setting applies to results saved with :SAVE:RESults:[STARt].
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether measurement results are saved with analysis results. |
Specifies whether found search event times are included when analysis results are saved. Analysis results are saved using :SAVE:RESults:[STARt].
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables saving found search event times. |
Specifies whether segmented memory acquisition times will be included when analysis results are saved. Analysis results are saved using :SAVE:RESults:[STARt], and multiple result types are saved to the same file separated by a blank line.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enable or disable inclusion of segmented memory acquisition times when saving analysis results. |
Saves an oscilloscope setup. If a <file_name> is provided, any file extension must be ".scp".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification for the saved setup, either an internal location or a file name. |
Saves oscilloscope waveform data to a file. Set :SAVE:WAVeform:FORMat before saving; if a provided file extension conflicts with the selected format, the format may be changed when the extension is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string naming the destination file. |
Sets the waveform data format type. The query returns the selected waveform data format type.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | ASCiixy | CSV | BINary | Selects the waveform data format type. |
Sets the waveform data length, i.e. the number of points saved, when :SAVE:WAVeform:LENGth:MAX is OFF. When :SAVE:WAVeform:LENGth:MAX is ON, this setting has no effect.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 100 - max. length | Waveform data length to save, in points. |
Specifies whether the maximum number of waveform data points is saved. When OFF, :SAVE:WAVeform:LENGth determines the number of waveform data points saved.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Controls whether maximum waveform length is saved. |
Specifies which acquired segments are included when saving a waveform while segmented memory is used. ALL saves all acquired segments; CURRent saves only the currently selected segment.
| Name | Type | Values | Description |
|---|---|---|---|
| option | enum | ALL | CURRent | Selects which waveform segments are saved. |
Selects the source to be saved as a reference waveform file. Only ADD or SUBtract math operations can be saved as reference waveforms.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Source to be saved as a reference waveform file. |
Saves oscilloscope waveform data to a reference waveform file. If a file extension is provided as part of <file_name>, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| <file_name>opt | string | - | Quoted ASCII string naming the reference waveform file. |
Returns the selected image area. When saving images, the query returns SCR (screen); when saving setups or waveform data, it returns GRAT (graticule) even though graticule images are not saved.
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 | Display setting for the serial decode bus. |
Determines the decode mode for the serial bus. This command is only valid when a serial decode option has been licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | A429 | FLEXray | CAN | CXPI | I2S | IIC | LIN | M1553 | MANChester | NRZ | SENT | SPI | UART | USB | USBPd | Sets the serial bus decode mode. |
Automatically sets several ARINC 429 decoding and triggering options. It configures trigger thresholds, noise reject, probe attenuation, vertical scale, serial decode, base, word format, trigger source, and trigger mode.
Selects between hexadecimal and binary display of the decoded ARINC 429 data. The setting does not affect the SDI and SSM fields, which are always displayed in binary, nor the Label field, which is always displayed in octal.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | Selects the display base. |
Sets the user-defined A429 baud rate for :SBUS<n>:A429:SPEed USER. The baud rate can be set in 100 b/s increments between 10000 and 100000 and in 1000 b/s increments between 100000 and 1000000.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 10000 - 1000000 | User-defined baud rate. |
Returns the error count.
Resets the word and error counters.
Returns the word count.
Specifies the ARINC 429 word decode format for the selected bus. The query returns the current word decode format setting.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | LDSDi | LDSSm | LDATa | ARINC 429 word decode format to use. |
Sets the ARINC 429 signal type for the selected :SBUS<n> path. The available choices are Line A, Line B, or Differential (A-B).
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | A | B | DIFFerential | Selects the signal type: A = Line A (non-inverted), B = Line B (inverted), or DIFFerential = Differential (A-B). |
Sets the source of the ARINC 429 signal. The query returns the currently set source of the ARINC 429 signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Source channel for the ARINC 429 signal. |
Sets the ARINC 429 signal speed. LOW selects 12.5 kb/s, HIGH selects 100 kb/s, and USER enables a user-defined baud rate via :SBUS<n>:A429:BAUDrate.
| Name | Type | Values | Description |
|---|---|---|---|
| speed | enum | LOW | HIGH | USER | ARINC 429 signal speed setting. |
Sets the ARINC 429 trigger label value when labels are used in the selected trigger type. To set the label value to don't cares (0xXX), set the value to -1.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | 8-bit label value in decimal, hexadecimal, octal, or string form. |
Defines the ARINC 429 data pattern resource according to the specified binary string. If more bits are sent than specified by :SBUS<n>:A429:FORMat, the most significant bits are truncated.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary pattern string, with characters 0, 1, or X. |
Defines the ARINC 429 two-bit SDI pattern resource according to the string parameter. The specified SDI is only used if :SBUS<n>:A429:FORMat includes the SDI field.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Two-bit SDI pattern string, where n ::= {0 | 1 | X}; length is always 2 bits. |
Defines the ARINC 429 two-bit SSM pattern resource from a binary string. The specified SSM is only used if the :SBUS<n>:A429:FORMat includes the SSM field.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string value for the two-bit SSM pattern, with n limited to {0, 1, X} and length always 2 bits. |
Defines a range of ARINC 429 label values used when the LRANge trigger type is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| min | integer | 0 - 255 | Lower label value of the trigger range. |
| max | integer | 0 - 255 | Upper label value of the trigger range. |
Sets the ARINC 429 trigger condition for the selected bus. The trigger can be set to word, label, parity, error, range, or bit-based conditions.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | WSTArt | WSTOp | LABel | LBITs | PERRor | WERRor | GERRor | WGERrors | ALLerrors | LRANge | ABITs | AOBits | AZBits | Selects the ARINC 429 trigger condition. |
Returns the error frame count.
Returns the overload frame count.
Resets the frame counters.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | - | Subsystem index. |
Returns the Spec error count, which is the sum of Ack, Form, Stuff, and CRC errors.
Returns the total frame count.
Returns the percent utilization for the CAN counter. The response is a floating-point value in NR3 format.
Specifies whether CAN symbolic data is displayed as symbolic values from the DBC file or as hexadecimal values in the decode waveform and Lister window. The query returns the CAN decode display type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | HEXadecimal | SYMBolic | Selects the CAN display format used for decoded symbolic data. |
Sets the CAN FD sample point, the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The setting is expressed as an even numbered percentage from 30 to 90 in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 30 - 90 | Even numbered percentage value for the CAN FD sample point. |
Selects the CAN FD frame decode standard used when decoding or triggering on FD frames. This setting has no effect on non-FD (classical) frames.
| Name | Type | Values | Description |
|---|---|---|---|
| std | enum | ISO | NISO | CAN FD frame decode standard. |
Sets the CAN sample point, the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The sample point represents the percentage of time between the beginning and end of the bit time.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 30.0 - 90.0 | Percentage of the bit time at which the CAN bit level is sampled. |
Sets the standard baud rate of the CAN signal. Values from 10 kb/s to 4 Mb/s must be entered in 100 b/s increments; 5 Mb/s is also allowed.
| 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 |
|---|---|---|---|
| signal type | enum | CANH | CANL | RX | TX | DIFFerential | DIFL | DIFH | CAN signal type to use. |
Sets the CAN FD baud rate for the selected serial bus channel. The value is rounded to the nearest 100 b/s if needed.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 10000 - 10000000 | CAN FD baud rate to set, in 100 b/s increments. |
Sets the source for the CAN signal. The query returns the current source for the CAN signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for the CAN signal. |
Sets the CAN trigger condition for the selected :SBUS<n> bus. The available conditions include frame, error, overload, message, and symbolic message/signal trigger types.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | SOF | EOF | IDData | DATA | FDData | IDRemote | IDEither | ERRor | ACKerror | FORMerror | STUFferror | CRCerror | SPECerror | ALLerrors | BRSBit | CRCDbit | EBActive | EBPassive | OVERload | MESSage | MSIGnal | FDMSignal | CAN trigger condition to set. |
Specifies, in certain error and bit trigger modes, whether triggers are filtered by CAN IDs.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables CAN ID trigger filtering. |
Defines the CAN data pattern resource from a string parameter. The string may be binary or hexadecimal with X and $ don't-care characters, and is used with the data length setting to control the data pattern searched for in CAN messages.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hexadecimal pattern string; binary uses 0, 1, and X, while hexadecimal may start with 0x and uses hex digits plus X. |
:SBUS<n>:CAN:TRIGger:PATTern:DATA <string> :SBUS<n>:CAN:TRIGger:PATTern:DATA?
Specifies the DLC value to be used in CAN FD data trigger mode. A valid FD value may be set, or -1 to indicate "don't care".
| Name | Type | Values | Description |
|---|---|---|---|
| dlc | integer | -1 - 64 | DLC value to use for the CAN FD data trigger mode. |
Sets the number of 8-bit bytes in the CAN data string. The value can be from 1 to 8 bytes, and the data bytes are set by :SBUS<n>:CAN:TRIGger:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Number of 8-bit bytes in the CAN data string. |
Specifies the starting byte position for CAN FD data triggers. CAN FD frames can have up to 64 bytes of data, and the setting lets you trigger on data anywhere within the frame.
| Name | Type | Values | Description |
|---|---|---|---|
| start | integer | 0 - 63 | Starting byte position. |
Defines the CAN identifier pattern resource from a string parameter. The string may be binary using 0, 1, and X (or $) characters, or hexadecimal when prefixed with "0x"; the pattern is always 29 bits and longer strings are truncated.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CAN identifier pattern string. |
Sets the CAN identifier mode. Standard selects the standard 11-bit identifier and Extended selects the extended 29-bit identifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STANdard | EXTended | CAN identifier mode. |
Specifies the CAN symbolic message to trigger on when CAN symbolic data has been loaded into the oscilloscope and the CAN trigger mode is set to MESSage or MSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string specifying the message. |
Specifies the CAN symbolic signal to trigger on after symbolic data has been loaded into the oscilloscope and the CAN trigger mode is set to MSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string naming the signal to trigger on. |
Specifies the signal value to trigger on when CAN symbolic data has been loaded into the oscilloscope and CAN trigger mode is set to MSIGnal. Encoded signal values are not supported in the remote interface.
| Name | Type | Values | Description |
|---|---|---|---|
| data | numeric | - | Signal value in NR3 format. |
Sets or queries the CXPI baud rate for the selected bus. The baud rate can be set from 9600 b/s to 40000 b/s in 100 b/s increments; default is 20 kb/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 9600 - 40000 | Baud rate setting in 100 b/s increments. |
Specifies whether the parity bit should be displayed in the identifier field. When OFF, the upper bit is masked; parity is still checked and only displayed if a parity error occurs.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | - | Subsystem number. |
| state | enum | 0 | OFF | 1 | ON | Sets parity display on or off. |
Selects the oscilloscope channel connected to the CXPI signal line. The query returns the selected oscilloscope channel source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Oscilloscope channel to use as the CXPI signal line source. |
Sets the tolerance as a percentage of the Tbit width. The query returns the current tolerance setting.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | integer | 1 - 30 | Tolerance percentage in NR1 format. |
Selects the CXPI trigger type for the selected bus source. The query returns the current trigger type setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SOF | EOF | PTYPe | ID | DATA | LDATa | CRCerror | PARityerror | IBSerror | IFSerror | FRAMingerror | DLENgtherror | SAMPleerror | ALLerrors | SLEepframe | WAKeuppulse | CXPI trigger type to select. |
Enables or disables modifying the CXPI trigger so it occurs only for a specified ID when triggering on certain error conditions.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether ID filtering is disabled or enabled. |
Specifies whether CXPI trigger on data should occur when the special PTYPE byte is present or not present. Use ON to trigger when PTYPE is present, or OFF to trigger when it is not present.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether the trigger is set for PTYPE present or absent. |
Specifies the CXPI trigger pattern data value for trigger types that support data triggering. The data value may be entered as a quoted binary string or as a quoted hexadecimal string.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data value to use in the trigger pattern. |
Sets the data length used for CXPI pattern trigger-on-data conditions. The value is limited by the DLC setting of :SBUS<n>:CXPI:TRIGger:PATTern:INFO:DLC.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 0 - 12 | Data length to trigger on, in bytes. |
Sets the start byte location for a CXPI pattern trigger data value. Use it when triggering on long frames to specify where the data value should be found.
| Name | Type | Values | Description |
|---|---|---|---|
| start | integer | 0 - 124 | Start byte location, in NR1 format. |
Sets the CXPI trigger pattern frame ID value for the selected bus. For trigger types that allow frame ID specification or filtering by frame ID, this command defines the frame ID used.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Frame ID value, expressed as a quoted binary-format string or as a hexadecimal-format string with 0x prefix. |
Specifies the Count (CT) value of the CXPI frame to trigger on for trigger types that allow triggering on data, frame ID, and frame information bits. The value is a two-bit binary string.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Two-bit binary CT value, written as "nn" where n is 0, 1, or X. |
Sets the data length code used for CXPI trigger pattern matching on data-trigger types. The allowed range depends on trigger mode: DATA mode accepts -1 to 15, and LDATa mode accepts -1 to 255.
| Name | Type | Values | Description |
|---|---|---|---|
| dlc | integer | -1 - 15 | Data length code of the CXPI frame to trigger on. |
Specifies the Network Management (NM) value of the CXPI frame to trigger on. This is a two-bit binary value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Two-bit binary NM value, printed as "nn" where n is 0, 1, or X. |
Automatically configures oscilloscope settings to facilitate FlexRay triggering and serial decode. It sets the selected source channel impedance, probe attenuation, trigger level, Noise Reject, Serial Decode, and the trigger to the specified serial bus.
Sets the FLEXray baud rate. The allowed settings are 2.5 Mb/s, 5 Mb/s, or 10 Mb/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 2500000 - 10000000 | Baud rate to use for FLEXray. |
Specifies the bus channel, A or B, of the FlexRay signal.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | A | B | Selects the FlexRay bus channel. |
Returns the FlexRay null frame count.
Resets the FlexRay frame counters.
Returns the FlexRay sync frame count.
Returns the FlexRay total frame count.
Specifies the input source for the FlexRay signal. The query returns the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Input source for the FlexRay signal. |
Sets the FLEXray trigger condition. The query returns the current FLEXray trigger condition.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | FRAMe | ERRor | EVENt | Selects the FLEXray trigger condition: frames, error frames/unknown bus conditions, or FlexRay event/symbol. |
Selects the FlexRay error type to trigger on. The setting is only valid when the FlexRay trigger mode is set to ERRor.
| Name | Type | Values | Description |
|---|---|---|---|
| error_type | enum | ALL | HCRC | FCRC | Selects which FlexRay error type to trigger on. |
:SBUS<n>:FLEXray:TRIGger:ERRor:TYPE?
Automatically configures oscilloscope settings for the selected event trigger.
Sets the frame ID used by the Byte Start Sequence (BSS) event trigger. This setting is only valid if the trigger mode is EVENt and the EVENt:TYPE is BSS.
| Name | Type | Values | Description |
|---|---|---|---|
| frame_id | enum | ALL | Frame ID used for the BSS event trigger setup. |
Selects the FlexRay event to trigger on. The setting is only valid when the FlexRay trigger mode is set to EVENt.
| Name | Type | Values | Description |
|---|---|---|---|
| event | enum | WAKeup | TSS | FES | DTS | BSS | FlexRay event to trigger on. |
Sets the base of the FlexRay cycle count in the frame header to trigger on. The setting is only valid when the FlexRay trigger mode is set to FRAME.
| Name | Type | Values | Description |
|---|---|---|---|
| cycle_count_base | integer | 0 - 63 | Base of the FlexRay cycle count to trigger on. |
Sets the repetition number of the FlexRay cycle count in the frame header to trigger on. This setting is only valid when the FlexRay trigger mode is set to FRAME.
| Name | Type | Values | Description |
|---|---|---|---|
| cycle_count_repetition | enum | ALL | 2 | 4 | 8 | 16 | 32 | 64 | Cycle count repetition to trigger on. |
Sets the FlexRay frame ID to trigger on. The setting is only valid when the FlexRay trigger mode is set to FRAMe.
| Name | Type | Values | Description |
|---|---|---|---|
| frame_id | enum | ALL | FlexRay frame ID to trigger on, or ALL. |
Sets the FlexRay frame type to trigger on. This setting is only valid when the FlexRay trigger mode is set to FRAME.
| Name | Type | Values | Description |
|---|---|---|---|
| frame_type | enum | NORMal | STARtup | NULL | SYNC | NSTArtup | NNULl | NSYNc | ALL | Selects which FlexRay frame type the trigger responds to. |
:SBUS<n>:FLEXray:TRIGger:FRAMe:TYPE <frame_type> :SBUS<n>:FLEXray:TRIGger:FRAMe:TYPE?
Selects the I2S bus data alignment for the serial decoder and/or trigger when in I2S mode. The word select (WS) polarity is specified separately with :SBUS<n>:I2S:WSLow.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | I2S | LJ | RJ | Sets the I2S data alignment to standard, left justified, or right justified. |
Determines the base used for the I2S decode display. The query returns the current I2S display decode base.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | DECimal | HEX | Selects the I2S decode display base. |
Specifies which edge of the I2S serial clock signal clocks in data. NEGative selects the falling edge and POSitive selects the rising edge.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the I2S clock edge used to clock in data. |
:SBUS<n>:I2S:CLOCk:SLOPe <slope> :SBUS<n>:I2S:CLOCk:SLOPe?
Sets the width of the I2S receiver (decoded) data word. The width can be set from 4 to 32 bits.
| Name | Type | Values | Description |
|---|---|---|---|
| receiver | integer | 4 - 32 | Receiver data word width in bits. |
Controls which signal is used as the serial clock (SCLK) source by the serial decoder and/or trigger when in I2S mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the I2S serial clock source for DSO models. |
Controls which signal is used as the I2S serial data (SDATA) source for the serial decoder and/or trigger when in I2S mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Selects the SDATA source. |
Controls which signal is used as the word select (WS) source by the serial decoder and/or trigger when in I2S mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the WS source for DSO models. |
Sets the I2S trigger operator for the selected :SBUS<n> bus. The query returns the current I2S trigger operator.
| Name | Type | Values | Description |
|---|---|---|---|
| operator | enum | EQUal | NOTequal | LESSthan | GREaterthan | INRange | OUTRange | INCReasing | DECReasing | I2S trigger operator to use. |
Specifies the audio channel used for I2S trigger selection. The query returns the current audio channel for the I2S trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| audio_ch | enum | RIGHt | LEFT | EITHer | Audio channel to trigger on. |
Sets the I2S trigger data pattern searched for in each I2S message. The pattern is specified as a string whose interpretation depends on the base selected by :SBUS<n>:I2S:TRIGger:PATTern:FORMat; queried values return the current pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | I2S trigger data pattern string. Allowed characters depend on the selected base: decimal, binary, or hexadecimal. |
Sets the entry number base used by :SBUS<n>:I2S:TRIGger:PATTern:DATA, and queries return the currently set number base for I2S pattern data. The default base is DECimal.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | DECimal | Entry number base to use. |
Sets the lower and upper range boundaries used by the INRange, OUTRange, INCReasing, and DECReasing trigger conditions. The parameters may be entered in any order; the smaller value becomes the lower boundary and the larger value becomes the upper boundary.
| Name | Type | Values | Description |
|---|---|---|---|
| lower | integer | - | Lower range boundary. |
| upper | integer | - | Upper range boundary. |
Sets the width of the transmitted I2S data word. The width can be set from 4 bits to 32 bits.
| Name | Type | Values | Description |
|---|---|---|---|
| word_size | integer | 4 - 32 | I2S transmitted data word width in NR1 format. |
Selects the polarity of the I2S word select (WS) signal for the specified serial bus. LEFT means WS low indicates left-channel data; RIGHt means WS low indicates right-channel data.
| Name | Type | Values | Description |
|---|---|---|---|
| low_def | enum | LEFT | RIGHt | Selects which channel is indicated when WS is low. |
Determines whether the Read/Write bit is included as the LSB in the display of the IIC address field of the decode bus.
| Name | Type | Values | Description |
|---|---|---|---|
| size | enum | BIT7 | BIT8 | Sets the IIC address width setting. |
Sets the source for the IIC serial clock (SCL).
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for the IIC serial clock. |
Sets the source for IIC serial data (SDA). The query returns the current source for IIC serial data.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for IIC serial data (SDA). |
Sets the IIC data address. The address may be given as an integer or as a hexadecimal string and can use a don't-care value to ignore the address.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0x00 - 0x7F | Address value for IIC data. |
Sets the IIC trigger pattern data. The value may be entered as an integer or as a hex string; use the don't care pattern (-1 or 0xFFFFFFFF) to ignore the data value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0x00 - 0x0FF | IIC data value to set. |
Sets IIC data 2 for the trigger pattern. The data value can range from 0x00 to 0x0FF, and the don't care data pattern (-1 or 0xFFFFFFFF) may be used to ignore the data value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | 0x00 - 0x0FF | Data value for IIC data 2; may also be an integer or a hexadecimal string of the form "0xnn". |
Sets the IIC data qualifier when TRIGger:IIC:TRIGger[:TYPE] is set to READEprom. The query returns the current IIC data qualifier value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | LESSthan | GREaterthan | IIC data qualifier to set. |
Sets the IIC trigger type for the selected bus. The query returns the current IIC trigger type value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STARt | STOP | RESTart | ADDRess | ANACk | DNACk | NACKnowledge | READEprom | READ7 | WRITe7 | R7Data2 | W7Data2 | WRITe10 | IIC trigger type to set. |
Specifies whether LIN symbolic data is displayed as symbolic values from the LDF file or as hexadecimal values in the decode waveform and Lister window. The query returns the LIN decode display type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | HEXadecimal | SYMBolic | Selects the LIN display format. |
Determines whether the LIN parity bits are included as the most significant bits in the display of the Frame Id field in the LIN decode bus.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Sets whether parity bits are shown as the MSB in the Frame Id display. |
Sets the point during the bit time where the LIN bit level is sampled to determine whether the bit is dominant or recessive. The sample point is expressed as a percentage of bit time and is not limited by baud rate.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 60 | 62.5 | 68 | 70 | 75 | 80 | 87.5 | Sample point value in NR3 format. |
Sets the standard baud rate of the LIN signal. Values are rounded to the nearest 100 b/s increment if needed.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 2400 - 625000 | Standard LIN baud rate in 100 b/s increments. |
Sets the source for the LIN signal. The query returns the current source for the LIN signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for the LIN signal. |
Sets the LIN standard in effect for triggering and decoding. The setting selects LIN 1.3, LIN 1.3 with no length control, or LIN 2.X.
| Name | Type | Values | Description |
|---|---|---|---|
| std | enum | LIN13 | LIN13NLC | LIN20 | LIN standard to use. |
Sets the LIN sync break length to 11, 12, or 13 clock lengths. The sync break is the idle period at the beginning of each packet that distinguishes one information packet from the previous one.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 11 - 13 | Length of the LIN sync break in clock lengths. |
Sets the LIN trigger condition for the selected bus. The query returns the current LIN trigger value.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | SYNCbreak | ID | DATA | PARityerror | CSUMerror | FRAMe | FSIGnal | Selects the LIN trigger condition. |
Defines the LIN identifier searched for in each CAN message when LIN trigger mode is set to frame ID. Setting the ID to -1 results in 0xXX, equivalent to all IDs.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 63 | LIN identifier value to store. |
Sets the LIN trigger data pattern searched for in each LIN data field. The pattern is specified as a string whose format depends on :SBUS<n>:LIN:TRIGger:PATTern:FORMat, and the query returns the currently specified pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | LIN trigger data pattern string. |
Sets the number of 8-bit bytes in the LIN data string. The value can be from 1 to 8 bytes and is set by :SBUS<n>:LIN:TRIGger:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Number of 8-bit bytes in the LIN data string. |
:SBUS<n>:LIN:TRIGger:PATTern:DATA:LENGth <length>
Sets the entry number base used by :SBUS<n>:LIN:TRIGger:PATTern:DATA, and the same setting is available by query. The default base is BINary.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | DECimal | Entry number base used for LIN pattern data. |
Specifies the LIN symbolic message to trigger on when symbolic data has been loaded into the oscilloscope and the LIN trigger mode is set to FRAMe or FSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string naming the message to trigger on. |
Specifies the signal to trigger on when LIN symbolic data has been loaded into the oscilloscope and the LIN trigger mode is set to FSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string identifying the signal to trigger on. |
:SBUS<n>:LIN:TRIGger:SYMBolic:SIGNal <name> :SBUS<n>:LIN:TRIGger:SYMBolic:SIGNal?
Specifies the signal value to trigger on when LIN symbolic data has been loaded into the oscilloscope and the LIN trigger mode is set to FSIGnal. Encoded signal values are not supported in the remote interface.
| Name | Type | Values | Description |
|---|---|---|---|
| data | numeric | - | Signal value in NR3 format. |
Automatically sets MIL-STD-1553 decode and trigger options for the specified serial bus. It sets the trigger thresholds to ±1/3 division based on the source channel V/div, Noise Reject off, Probe Attenuation to 10.0, and Serial Decode on.
Determines the base used for the MIL-STD-1553 decode display. The query returns the current MIL-STD-1553 display decode base.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | Selects the decode display base. |
Sets the source of the MIL-STD 1553 signal. Use the trigger level commands to set threshold levels for the selected source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Source channel for the MIL-STD 1553 signal. |
Sets the 11 bits to trigger on when the trigger type has been set to RTA11 (RTA + 11 Bits). The value is an 11-character string made up of 0, 1, or X.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 11-bit trigger pattern string. |
Sets the Remote Terminal Address (RTA) to trigger on when the trigger type has been set to RTA or RTA11. To set the RTA value to don't cares (0xXX), set the value to -1.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 31 | Remote Terminal Address value to trigger on; may be entered as decimal, nondecimal (#Hnn), or string ("0xnn"). |
Specifies the MIL-STD-1553 trigger type to be used for :SBUS<n>:M1553 triggering. The query returns the currently set trigger type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | DSTArt | DSTOp | CSTArt | CSTOp | RTA | PERRor | SERRor | MERRor | RTA11 | MIL-STD-1553 trigger type. |
Sets the Manchester bus decode and Lister display base for :SBUS<n>:MANChester when the display format is WORD. When the display format is BIT, BINary is the only legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | HEX | DECimal | ASCii | BINary | Base for the Manchester bus decode and Lister display. |
Specifies the baud rate of the Manchester signal.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 500 - 5000000 | Baud rate in 100 b/s increments. |
Sets the Manchester bus bit order when the display format is WORD. The query returns the current bit order setting.
| Name | Type | Values | Description |
|---|---|---|---|
| bitorder | enum | MSBFirst | LSBFirst | Specifies whether the most significant or least significant bit is transmitted first. |
Specifies the format of the Manchester bus display. The query returns the bus display format setting.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BIT | WORD | Format of the Manchester bus display. |
Sets the number of words in the data field of the Manchester protocol definition when the display format is WORD. AUTO is only available when the trailer field size is 0.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AUTO | Selects automatic sizing. |
| words | integer | 1 - 255 | Number of words in the data field, in NR1 format. |
Sets the number of bits in the header field of the Manchester protocol definition when the display format is WORD. The query returns the current header field bits setting.
| Name | Type | Values | Description |
|---|---|---|---|
| <#bits> | integer | 0 - 32 | Number of bits in the header field of the Manchester protocol definition. |
Specifies the minimum idle time or inter-frame gap time in terms of the number of bits. The value is set in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | real | 1.50 - 32.00 | Minimum idle time in bits. |
Specifies the polarity of the Manchester signal. Falling edge encodes logic 1 and rising edge encodes logic 0, or vice versa depending on the selected setting.
| Name | Type | Values | Description |
|---|---|---|---|
| logic | enum | FALLing | RISing | Selects the Manchester signal polarity. |
Selects the oscilloscope channel connected to the Manchester signal line. The query returns the currently selected channel source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Channel source to use for the Manchester signal line. |
Specifies the number of sync bits for the Manchester signal. The query returns the current sync bits setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 255 | Number of sync bits. |
Specifies the starting edge of the Manchester signal. The query returns the current starting edge number setting.
| Name | Type | Values | Description |
|---|---|---|---|
| edge# | integer | 1 - 256 | Starting edge number in NR1 format. |
Specifies the tolerance for the Manchester signal in terms of the percentage of the bit period.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 5 - 30 | Tolerance percentage in NR1 format. |
Specifies the Manchester trigger mode for the selected serial bus. The query returns the current trigger mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SOF | VALue | MERRor | Sets the Manchester trigger mode to start of frame, specified bit values, or Manchester error. |
Sets the trigger value used when the Manchester trigger mode is set to VALue. The value is specified as a binary string, optionally with an 0x prefix for hexadecimal, and its bit width is set by the WIDTH command.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Trigger value to match; format is binary digits or 0x-prefixed hexadecimal digits with X and $ allowed. |
Sets the bit width (length) of the value to trigger on when VALue trigger mode is selected. The actual trigger value is set with :SBUS<n>:MANChester:TRIGger:PATTern:VALue:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 128 | Bit width (length) of the value to trigger on. |
Sets the number of bits in the trailer field of the Manchester protocol definition when the display format is WORD. The query returns the current trailer field bit setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 32 | Number of bits in the trailer field. |
Sets the number of bits per word in the Manchester protocol definition when the display format is WORD. The query returns the current number of bits per word setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 2 - 32 | Number of bits per word, in NR1 format. |
Sets the decode number base for the NRZ bus decode and Lister display when the display format is WORD. When the display format is BIT, BINary is the only legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | HEX | DECimal | ASCii | BINary | Decode number base to use for NRZ display. |
Specifies the baud rate of the NRZ signal.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 5000 - 5000000 | Baud rate in 100 b/s increments. |
Sets the bit order used for NRZ transmission when the display format is WORD. The query returns the current bit order setting.
| Name | Type | Values | Description |
|---|---|---|---|
| bitorder | enum | MSBFirst | LSBFirst | Specifies the order of transmission on the NRZ bus. |
Specifies the format of the NRZ bus display. The query returns the current bus display format setting.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BIT | WORD | Bus display format. |
Specifies the number of words in the data field of the NRZ protocol definition when the display format is WORD. AUTO is available only when the trailer field size is 0.
| Name | Type | Values | Description |
|---|---|---|---|
| #words | integer | 1 - 255 | Number of words in the data field. |
Sets the total NRZ frame size when the NRZ bus display format is BIT. The specified frame size is equivalent to the sum of the header, data, and trailer field bit counts in WORD format.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 2 - 255 | Total frame size in bits, specified in NR1 format. |
Sets the number of bits in the header field of the NRZ protocol definition when the display format is WORD. The query returns the current header field bits setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 32 | Number of bits in the header field of the NRZ protocol definition. |
Specifies the minimum idle time or inter-frame gap time in terms of the number of bits. The query returns the specified idle time in bits.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | real | 1.50 - 32.00 | Minimum idle time in NR3 format. |
Specifies the idle state of the NRZ signal. The query returns the current idle state setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | LOW | HIGH | Idle state for the NRZ signal. |
Specifies the polarity of the NRZ signal. HIGH uses a positive voltage for logic 1 and a negative voltage for logic 0; LOW uses a negative voltage for logic 1.
| Name | Type | Values | Description |
|---|---|---|---|
| logic | enum | HIGH | LOW | Sets the NRZ signal polarity. |
Selects the oscilloscope channel connected to the NRZ signal for the specified serial bus input.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Oscilloscope channel source to use. |
Specifies the number of start bits for the NRZ signal.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 255 | Number of start bits, expressed in NR1 format. |
Specifies the trigger mode for NRZ bus triggering. SOF triggers at the start of a frame; VALue triggers on specified bit values.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SOF | VALue | Trigger mode setting. |
Specifies the trigger value used when VALue trigger mode is selected. The value bit order is always interpreted as bits arrive (MSB first), regardless of the serial decode bit order setting, and the bit width is set by the WIDTh command.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Trigger value to use, expressed as a binary string or as a hexadecimal string prefixed with 0x. |
Sets the bit width (length) of the value to trigger on when VALue trigger mode is selected. The actual trigger value is set with :SBUS<n>:NRZ:TRIGger:PATTern:VALue:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 128 | Bit width (length) of the value to trigger on. |
Sets the number of bits in the trailer field of the NRZ protocol definition when the display format is WORD. The query returns the current trailer field bit setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 32 | Number of bits in the trailer field, specified in NR1 format. |
Specifies the number of bits per word in the data field of an NRZ protocol definition when the display format is WORD. The query returns the current bits-per-word setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 2 - 32 | Number of bits per word, entered in NR1 format. |
Specifies the nominal SENT clock period (tick). The query returns the current clock period setting.
| Name | Type | Values | Description |
|---|---|---|---|
| period | real | 500 ns - 300 us | Nominal clock period (tick), in NR3 format. |
Sets the CRC format used for SENT fast channel messages and short serial message CRCs. Enhanced Serial Message CRCs always use the 2010 format.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | LEGacy | RECommended | Specifies the CRC format. |
Sets the SENT decode number base used by the decoder for raw data nibbles, defined signals in other formats, and Serial Message data fields. When SYMBolic is selected, Fast Channel Signals are displayed as calculated physical values; CRC and Slow Channel information are displayed in hex.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | HEX | DECimal | SYMBolic | Number base used by the decoder. |
Sets the SENT message decode/triggering format for the selected bus. The choice affects both decoding and triggering.
| Name | Type | Values | Description |
|---|---|---|---|
| decode | enum | NIBBles | FSIGnal | FSSerial | FESerial | SSERial | ESERial | Selects the message decode/triggering format. |
Specifies the idle state of the SENT bus. The query returns the idle state setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | LOW | HIGH | Sets the SENT bus idle state. |
Sets the number of nibbles in a SENT message. The query returns the current nibble setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #_nibbles | integer | 1 - 6 | Number of nibbles in the SENT message. |
Specifies whether there is a pause pulse between Fast Channel Messages on the SENT serial bus. The query returns the current pause mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | 0 | OFF | 1 | ON | SPC | Selects the SENT pause pulse mode: no pause pulse, pause pulses enabled, or Short PWM Code (SPC). |
Specifies whether the given signal is on or off. The query returns the signal on/off setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | On/off state for the selected signal. |
Specifies the bit length of the signal being defined. The query returns the current signal bit length setting.
| Name | Type | Values | Description |
|---|---|---|---|
| s | integer | 1 - 6 | Signal index. |
| length | integer | 1 - 24 | Bit length of the signal being defined. |
Sets the multiplier used to calculate a physical value displayed for a Fast Channel Signal when the display mode is SYMBolic. The query returns the current multiplier value.
| Name | Type | Values | Description |
|---|---|---|---|
| <multiplier> | real | 1 - 24 | Multiplier value in NR3 format. |
Sets the offset value for the Fast Channel Signal. When the display mode is SYMBolic, this offset is used in calculating the physical value displayed for the Fast Channel Signal.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | 1 - 24 | Offset value in NR3 format. |
Specifies the nibble order of the signal being defined for fast signal decoding, either most-significant nibble first or least-significant nibble first.
| Name | Type | Values | Description |
|---|---|---|---|
| order | enum | MSNFirst | LSNFirst | Sets the nibble order to most-significant nibble first or least-significant nibble first. |
:SBUS<n>:SENT:SIGNal<s>:ORDer <order>
Specifies the starting bit of the Fast Signal being defined. The query returns the Fast Signal starting bit setting.
| Name | Type | Values | Description |
|---|---|---|---|
| position | integer | 0 - 23 | Starting bit position of the Fast Signal. |
Specifies the input channel for SENT decode and triggering. The query returns the currently specified SENT input source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input source for SENT decode and triggering. |
Sets the tolerance used to determine whether the sync pulse is valid. The query returns the current tolerance setting.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 3 - 30 | Tolerance percentage in NR1 format. |
Sets the SENT trigger mode. The query returns the current trigger mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SFCMessage | SSCMessage | FCData | SCMid | SCData | TOLerror | FCCerror | SCCerror | CRCerror | PPERror | SSPerror | Selects the SENT trigger condition. |
Specifies the status and data nibbles that are triggered on when FCData trigger mode is chosen. The query returns the fast channel data trigger setting.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | String specifying the fast channel data trigger setting. |
Specifies the data to trigger on for the Slow Channel Message ID and Data trigger mode. The query returns the current slow channel ID and data trigger data value setting.
| Name | Type | Values | Description |
|---|---|---|---|
| data | integer | -1 - 65535 | Data value to trigger on when ILENgth is SHORt. |
Specifies the ID to trigger on for the "Slow Channel Message ID" and "Slow Channel Message ID & Data" trigger modes. The allowed range depends on the slow-channel message length setting.
| Name | Type | Values | Description |
|---|---|---|---|
| id | integer | -1 - 15 | ID to trigger on when ILENgth is SHORt. |
Specifies the ID and data lengths for the Slow Message Enhanced messages. Use SHORt for the 4-bit ID, 16-bit data format or LONG for the 8-bit ID, 12-bit data format.
| Name | Type | Values | Description |
|---|---|---|---|
| length | enum | SHORt | LONG | Selects the ID and data length format. |
:SBUS<n>:SENT:TRIGger:SLOW:ILENgth <length> :SBUS<n>:SENT:TRIGger:SLOW:ILENgth?
Sets the trigger tolerance variation considered a violation for :SBUS<n> SENT triggering. The tolerance can be from 1 to 28 percent and must not exceed the associated :SBUS<n>:SENT:TOLerance setting minus two percent.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | integer | 1 - 28 | Tolerance variation percent setting in NR1 format. |
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, either least significant bit first or most significant bit first. |
Sets the SPI clock source slope used to clock in the data. Use POSitive for the rising edge or NEGative for the falling edge.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Specifies whether the SPI clock source uses the falling or rising edge. |
Sets the SPI signal clock timeout resource in seconds when :SBUS<n>:SPI:FRAMing is set to TIMeout. The timer is used to frame a signal by a clock timeout.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 100 ns - 10 s | Time in seconds in NR3 format. |
Specifies the number of bits to ignore before decoding the MISO stream. The query returns the specified number of delay bits, or "OFF" if there are none.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 2-63 | Number of bits to ignore before decoding the MISO stream. |
Sets the SPI trigger framing value. If TIMeout is selected, the timeout is set by :SBUS<n>:SPI:CLOCk:TIMeout. The NOTC value is deprecated and equivalent to NCHipselect.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHIPselect | NCHipselect | NOTC | TIMeout | SPI trigger framing value. |
Sets the source for the SPI serial clock. The query returns the current source for the SPI serial clock.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the SPI serial clock for DSO models. |
Sets the frame source for the SPI serial frame when :SBUS<n>:SPI:FRAMing is set to CHIPselect or NOTChipselect. The query returns the current frame source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Frame source for DSO models. |
| source | enum | CHANnel<n> | DIGital<d> | Frame source for MSO models. |
Sets the source for the SPI serial MISO data. The allowed source keywords depend on the model family (DSO or MSO).
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | CHANnel<n> | DIGital<d> | Selects the source used for SPI MISO data. |
Sets the source for the SPI serial MOSI data. The valid source depends on the model family: DSO models use channel or external sources, while MSO models use channel or digital sources.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the SPI serial MOSI data on DSO models. |
Defines the SPI data pattern resource from a string parameter. The string may be binary using 0, 1, and X, or hexadecimal if prefixed with "0x"; set :SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh before using this command.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Pattern string made up of 0, 1, and X, or a hexadecimal string beginning with "0x" and containing hexadecimal digits and X characters. |
Sets the width of the SPI data pattern. The width can be set from 4 to 64 bits and should be set before :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | SPI data pattern width in bits. |
Defines the SPI MOSI data pattern resource from a string parameter. The string may be binary (0, 1, X, $) or hexadecimal if it starts with "0x"; set the MOSI width before using this command.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hexadecimal pattern string used to define the SPI data pattern resource. |
Sets the width of the SPI data pattern in MOSI, from 4 bits to 64 bits. The width should be set before :SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | Width of the SPI data pattern in bits. |
Specifies whether the SPI trigger is based on MOSI data or MISO data. The query returns the current SPI trigger type setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MOSI | MISO | Selects whether the SPI trigger uses MOSI data or MISO data. |
Sets the number of bits in a SPI data word for the selected bus. The query returns the current SPI decode word width.
| Name | Type | Values | Description |
|---|---|---|---|
| word_width | integer | 4 - 16 | Number of bits in a SPI word, specified as an NR1 integer from 4 to 16. |
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 base format. |
Sets the bit rate in bps for the serial decoder and/or trigger when in UART mode. The baud rate can be set from 100 b/s to 8 Mb/s, or to the specific values of 10 Mb/s or 12 Mb/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 100 - 8000000 | Bit rate in bps for the UART serial decoder and/or trigger. |
:SBUS<n>:UART:BAUDrate <baudrate>
Sets the bit order used for UART transmission on the physical Tx and Rx input signals for the serial decoder and/or trigger. LSBFirst transmits the least significant bit first; MSBFirst transmits the most significant bit first.
| Name | Type | Values | Description |
|---|---|---|---|
| bitorder | enum | LSBFirst | MSBFirst | Bit order used for UART mode 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 UART decode framing (end of packet), or turns framing off. The query returns the current UART decode base setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | Framing control keyword or a byte value for UART decode framing. |
Selects the parity to be used with each message byte for the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| parity | enum | EVEN | ODD | NONE | Parity setting to use. |
Selects the UART polarity as idle low or idle high for the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | HIGH | LOW | Sets the UART polarity. |
Controls which signal is used as the Rx source by the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Selects the UART Rx source. |
Controls which signal is used as the UART Tx source by the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Selects the Tx source for DSO models. |
Sets the front panel UART/RS232 trigger setup data selection option. ASCII selects data selection from ASCII values; HEX selects data selection from hexadecimal values.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Selects the UART trigger data base. |
Selects the UART trigger burst value, i.e. the Nth frame after the idle period, for UART trigger mode. The value may be set to OFF or a burst count from 1 to 4096.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 1 to 4096 in NR1 format | Burst value (Nth frame after idle period) for UART trigger mode. |
Sets the UART trigger data byte value for the selected trigger qualifier when in UART mode. The value is used when RD or TD trigger types are selected.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | 8-bit data byte value to use for the UART trigger qualifier; may be entered in decimal, hexadecimal, binary, or quoted-string form. |
Sets the UART trigger idle period used for burst trigger operation in UART mode. The value must be between 1 us and 10 s in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 1 us - 10 s | Idle period time for UART burst trigger. |
Selects the data qualifier used for UART triggers when :TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX. The query returns the current UART trigger qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | GREaterthan | LESSthan | Data qualifier for the UART trigger. |
Selects the UART trigger type for the specified bus. When an RD or TD type is selected, :SBUS<n>:UART:TRIGger:DATA and :SBUS<n>:UART:TRIGger:QUALifier are used to specify the data value and comparison operator.
| 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 current setting can be queried with the corresponding ? form.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 5 - 9 | Number of bits per UART message byte. |
:SBUS<n>:UART:WIDTh <width> :SBUS<n>:UART:WIDTh?
Determines the base used for USB decode and Lister display, controlling how the data or payload field is displayed. All other fields are displayed in hex.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | BINary | DECimal | HEX | Specifies the display base for USB decode and Lister display. |
Specifies which signal is used as the USB D- source for the selected bus. The D- source is only used for Low and Full Speed USB.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the source signal for the USB D- input. |
Specifies which signal is used as the USB D+ source for the selected bus. The D+ source is only used for Low and Full Speed USB.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the source signal for USB D+; for MSO models, digital channels are also allowed. |
Specifies which signal is used as the differential source for the selected bus. Differential sources are only used for High Speed USB.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the differential source channel. |
Specifies the USB interface speed for the selected bus. The query returns the current speed setting.
| Name | Type | Values | Description |
|---|---|---|---|
| speed | enum | LOW | FULL | HIGH | USB interface speed setting. |
Specifies the USB trigger mode for the selected bus. The query returns the specified USB trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | SOP | EOP | ENTersuspend | EXITsuspend | RESet | TOKen | DATA | HANDshake | SPECial | ALLerrors | PIDerror | CRC5error | CRC16error | GLITcherror | STUFFerror | SE1error | USB trigger mode to set. |
Specifies the 7-bit Address portion of the USB trigger for the selected bus, in binary or hex.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 7-bit address value, entered as a binary string or hexadecimal string. |
Specifies the CRC portion of the USB trigger for the selected bus, in binary or hex. The query returns the specified CRC portion.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CRC value to set, formatted either as a binary string or as hexadecimal. |
Specifies the Data portion of the trigger for the selected bus, in binary or hex. See :SBUS<n>:USB:TRIGger:DATA:LENGth for setting the data value length.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data portion of the trigger value, formatted as binary or hex string. |
:SBUS<n>:USB:TRIGger:DATA <string> :SBUS<n>:USB:TRIGger:DATA?
Specifies the USB trigger data length in bytes. The query returns the specified data length.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 20 | Data length in bytes. |
Specifies the 4-bit Endpoint portion of the trigger for the selected bus, in binary or hex. The query returns the specified Endpoint portion.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 4-bit Endpoint value, expressed as binary or hex text. |
Specifies the 2-bit ET portion of the trigger for the selected bus, in binary or hex. The query returns the specified ET portion.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | ET value in binary "nn" or hex "0xn" format. |
Specifies the 11-bit Frame portion of the USB trigger for the selected bus, in binary or hex. The query returns the specified Frame portion.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 11-bit frame value in binary or hexadecimal format. |
Specifies the 7-bit Hub Address portion of the trigger for the selected bus, in binary or hex.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hub Address value, formatted as a 7-bit binary string or as a hexadecimal string. |
Specifies the 4-bit PID check portion of the trigger for the selected bus, in binary or hex. See the PID commands for setting the PID.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 4-bit PID check portion of the trigger, expressed as either binary "nnnn" or hexadecimal "0xn". |
Specifies the USB data PID to trigger on for the selected bus. The PID does not include the PID check value, which is set by :SBUS<n>:USB:TRIGger:PIDCheck.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | DATA0 | DATA1 | DATA2 | MDATa | Specifies the USB data PID to trigger on. |
Specifies the USB handshake PID to trigger on for the selected bus. The specified PID does not include the PID check value, which is set using :SBUS<n>:USB:TRIGger:PIDCheck.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | ACK | NAK | STALl | NYET | USB handshake PID to trigger on. |
Specifies the USB special PID to trigger on for the selected bus. The specified PID does not include the PID check value, which is set using :SBUS<n>:USB:TRIGger:PIDCheck.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | PING | PRE | ERR | SPLit | USB special PID to trigger on. |
Specifies the USB token PID to trigger on for the selected bus. The query returns the specified token PID.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | OUT | IN | SETup | SOF | USB token PID to trigger on. |
Specifies the 7-bit Port portion of the trigger for the selected bus, in binary or hex. The query returns the specified Port portion of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 7-bit port value encoded as either binary or hex. |
Specifies the 1-bit SC portion of the trigger for the selected bus, in binary or hex.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | SC portion value in binary or hex, formatted as "n" or "0xn". |
Specifies the 2-bit S and E or U portion of the trigger for the selected bus, in binary or hex. The query returns the specified S and E or U portion of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hex encoded trigger bits, using 0, 1, X, and in hex form 0-9, A-F, X, as shown in the syntax. |
Selects the USB PD waveform source. Analog channels can be used as the source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the USB PD waveform source. |
Selects the USB PD trigger mode. The query returns the selected USB PD trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | PSTart | EOP | SOP | SPPrime | SDPRime | SPDebug | SDPDebug | HRST | CRST | CRCerror | PERRor | HEADer | USB PD trigger mode to select. |
Selects the USB Power Delivery trigger header type when Header Content trigger mode is selected. The chosen header type determines which related subcommand is used to specify the message or value details.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | CMESsage | DMESsage | EMESsage | VALue | Selects the trigger header type. |
Selects the USB Power Delivery control message type when Header trigger mode and Control Message header type are selected. The query returns the selected control message type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | GOODcrc | GOTOmin | ACCept | REJect | PING | PSRDy | GSRCap | GSNCap | DRSWap | PRSWap | VCSWap | WAIT | SRST | GSCX | GSTatus | FRSWap | GPSTatus | GCCodes | Control message type to select. |
Selects the USB Power Delivery data message type used when Header Content trigger mode and Data Message header type are selected. The query returns the selected data message type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | SRCap | REQuest | BIST | SNCap | BSTatus | ALERt | GCINfo | VDEFined | Data message type to select. |
Selects the USB Power Delivery extended message type used by Header Content trigger mode. The query returns the currently selected extended message type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | SCX | STATus | GBCap | GBSTatus | BCAP | GMINfo | MINFo | SREQuest | SRESponse | FREQuest | FRESponse | PSTatus | CINFo | CCODes | Selects the extended message type. |
Sets the user-defined USB PD header value when Header Content trigger mode and user-defined Value type are selected. The value is specified as a quoted binary-format string.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | User-defined header value in binary-format string form. |
Selects an additional qualifier for the Header Content trigger when Header Content trigger mode is selected. The query returns the currently selected header content trigger qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NONE | SOP | SPRIme | SDPRime | Additional qualifier for the Header Content trigger. |
Sets the LIN signal type for the specified serial bus. The only legal value is LIN, although the syntax lists LIN, RX, and TX.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | LIN | RX | TX | LIN signal type to use. |
Sets the source for the SPI serial MOSI data. This command is the same as :SBUS<n>:SPI:SOURce:MOSI.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | Source for the SPI serial MOSI data on DSO models. |
Returns the number of search events found.
Navigates to a found search event by event number. If :SEARch:STATe is ON, the horizontal position is changed so the specified event is located at the time reference.
| Name | Type | Values | Description |
|---|---|---|---|
| event_number | integer | - | The integer number of a found search event. |
:SEARch:EVENt <event_number> :SEARch:EVENt?
Selects the search mode. It is only valid when :SEARch:STATe is ON.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EDGE | GLITch | RUNT | TRANsition | SERial1 | SERial2 | PEAK | Search mode to select. |
Enables or disables the search feature. The query returns the current setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 0 | OFF | 1 | ON | Enables or disables search. |
Specifies the slope of the edge for the search. The query returns the current slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | Sets the edge slope used for the search. |
Selects the channel on which to search for edges. The query returns the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Channel to search for edges on. |
Sets the minimum pulse width duration for the selected :SEARch:GLITch:SOURce. The query returns that minimum pulse width duration time.
| Name | Type | Values | Description |
|---|---|---|---|
| greater_than_time | real | - | Minimum pulse width duration in NR3 format. |
Sets the maximum pulse width duration for the selected :SEARch:GLITch:SOURce. The query returns the pulse width duration time for :SEARch:GLITch:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | - | Maximum pulse width duration. |
| suffixopt | enum | s | ms | us | ns | ps | Time unit suffix appended to the duration value. |
Sets the polarity for the glitch (pulse width) search. The query returns the current polarity setting.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Polarity for the glitch search. |
Sets the glitch (pulse width) search qualifier, selecting whether the oscilloscope searches for pulse widths greater than, less than, or within a range of time values. The query returns the current glitch qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| operator | enum | GREaterthan | LESSthan | RANGe | Selects the glitch search mode. |
Sets the pulse width duration for the selected :SEARch:GLITch:SOURce. The two time parameters may be entered in any order; the smaller value becomes <greater_than_time> and the larger value becomes <less_than_time>.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | 15 ns - 10 seconds | Upper pulse-width limit. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower pulse-width limit. |
Selects the channel on which to search for glitches (pulse widths).
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | CHANnel<n> | Channel to search for glitches on. |
Sets the change in level, or hysteresis, required to recognize a peak. The threshold level units are determined by :FUNCtion<m>[:FFT]:VTYPe.
| Name | Type | Values | Description |
|---|---|---|---|
| delta_level | real | - | Required change in level to be recognized as a peak, in NR3 format. |
Sets the maximum number of FFT peaks to find. The value can be from 1 to 11 in NR1 format.
| Name | Type | Values | Description |
|---|---|---|---|
| number | integer | 1 - 11 | Maximum number of peaks to find. |
Selects the FFT math function waveform to search. The selected source must be an FFT waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | FUNCtion<m> | MATH<m> | FFT math function waveform source to search. |
Specifies the threshold level necessary to be considered a peak for FFT peak search. The threshold units are determined by :FUNCtion<m>[:FFT]:VTYPe.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | Necessary level to be considered a peak, in NR3 format. |
Sets the polarity for the runt search. The query returns the currently set runt polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | EITHer | Polarity used for the runt search. |
Specifies whether to search for a runt that is greater than a time value, less than a time value, or any time value.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | NONE | Selects the runt search qualifier. |
Selects the channel used to search for the runt pulse. The query returns the current runt search source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel on which to search for the runt pulse. |
Specifies the runt pulse time value used when searching for runt pulses whose widths are greater than or less than a time. The query returns the currently specified runt time value.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Floating-point time value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Specifies whether to search for edge transitions greater than or less than a time. The query returns the current transition search qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | Specifies whether to search for edge transitions greater than or less than a time. |
Selects whether to search for rising edge or falling edge transitions. The query returns the current transition search slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the transition search slope. |
Selects the channel on which to search for edge transitions. The query returns the current transition search source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Channel to use for transition search. |
Sets the time of the transition to search for. You can search for transitions greater than or less than this time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Time of the transition to search for. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Defines the ARINC 429 label value when labels are used in the selected search mode. The query returns the current label value in decimal format.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | ARINC 429 label value; may be entered as decimal, hexadecimal, octal, or a quoted string representation as documented. |
Selects the type of ARINC 429 information to find in the Lister display. The query returns the current ARINC 429 search mode condition.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | LABel | LBITs | PERRor | WERRor | GERRor | WGERrors | ALLerrors | Specifies which ARINC 429 condition to search for. |
Defines the ARINC 429 data pattern resource according to a binary string parameter. The pattern controls the data pattern searched for in each ARINC 429 word; excess bits are truncated to the specified format length.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string of bits ('0' and '1'); length depends on FORMat. |
Defines the ARINC 429 two-bit SDI pattern resource from a 2-bit binary string. The specified SDI is used only if :SBUS<n>:A429:FORMat includes the SDI field.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary pattern string, where n is 0 or 1 and the length is always 2 bits. |
:SEARch:SERial:A429:PATTern:SDI <string> :SEARch:SERial:A429:PATTern:SDI?
Defines the ARINC 429 two-bit SSM pattern resource according to the string parameter. The specified SSM is only used if the :SBUS<n>:A429:FORMat includes the SSM field.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string that specifies the two-bit SSM pattern; length is always 2 bits. |
Selects the type of CAN information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | IDEither | IDData | DATA | IDRemote | ERRor | ACKerror | FORMerror | STUFferror | CRCerror | ALLerrors | OVERload | MESSage | MSIGnal | Selects which CAN frame or message type to search for in the Lister display. |
Specifies the data value used when searching for Data Frame ID and Data. The data length is set with :SEARch:SERial:CAN:PATTern:DATA:LENGth.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data value in hexadecimal format, written as "0xnn...n" where n is 0-9, A-F, or X. |
Sets the length of the data value used when searching for Data Frame ID and Data. The corresponding query returns the current data length setting.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Length of the data value in NR1 format. |
Specifies the ID value used when searching for a CAN event. The value can be a standard ID or an extended ID, depending on the :SEARch:SERial:CAN:PATTern:ID:MODE setting.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | ID value in hexadecimal format, written as "0xnn...n" where n is 0-9, A-F, or X. |
:SEARch:SERial:CAN:PATTern:ID <string> :SEARch:SERial:CAN:PATTern:ID?
Specifies whether a standard ID value or an extended ID value is used when searching for a CAN event. The ID value is specified using the :SEARch:SERial:CAN:PATTern:ID command.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STANdard | EXTended | Selects the CAN pattern ID mode. |
Specifies the CAN symbolic message to search for when CAN symbolic data has been loaded into the oscilloscope and serial search mode is set to MESSage or MSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string specifying the message to search for. |
Specifies the CAN symbolic signal to search for when CAN symbolic data has been loaded and CAN serial search mode is set to MSIGnal. The query returns the specified signal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string naming the signal to search for. |
Specifies the signal value to search for when CAN symbolic data has been loaded into the oscilloscope and the CAN serial search mode is set to MSIGnal. The query returns the specified signal value.
| Name | Type | Values | Description |
|---|---|---|---|
| data | real | - | Value in NR3 format. |
Specifies the cycle value to find when searching for FlexRay frames. A cycle value of -1 is the same as ALL.
| Name | Type | Values | Description |
|---|---|---|---|
| cycle | integer | 0 - 63 | Cycle value to search for, or ALL. |
Specifies the data value to find when searching for FlexRay frames. The length of the data value is set by :SEARch:SERial:FLEXray:DATA:LENGth.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data value to search for, formatted as "0xnn...n". |
Sets the length of data values used when searching for FlexRay frames. The related query returns the current data length setting.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 12 | Specifies the data length in NR1 format. |
Specifies the frame ID value to find when searching for FlexRay frames. The query returns the current frame ID setting.
| Name | Type | Values | Description |
|---|---|---|---|
| frame_id | enum | ALL | Frame ID to search for, or ALL. |
Selects the type of FlexRay information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FRAMe | CYCLe | DATA | HERRor | FERRor | AERRor | Type of FlexRay information to search for. |
Specifies the channel on which to search for I2S events: right, left, or either channel. The query returns the current channel setting.
| Name | Type | Values | Description |
|---|---|---|---|
| audio_ch | enum | RIGHt | LEFT | EITHer | Channel to search for I2S events. |
Selects the type of I2S information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | LESSthan | GREaterthan | INRange | OUTRange | Selects the I2S search mode. |
Specifies the data word value used when searching for I2S events. The base of the entered value is set by :SEARch:SERial:I2S:PATTern:FORMat.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data word value to search for, entered as a signed decimal integer, a binary pattern using 0/1/X, or a hexadecimal pattern prefixed with 0x depending on the selected base. |
Specifies the number base used with the :SEARch:SERial:I2S:PATTern:DATA command. The query returns the current number base setting.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | DECimal | Number base to use for pattern data. |
Specifies the data value range used when searching for I2S events in the INRange and OUTRange search modes. The smaller entered value becomes <lower> and the larger becomes <upper>, and the parameters may be entered in any order.
| Name | Type | Values | Description |
|---|---|---|---|
| lower | integer | - | Lower data value in the search range. |
| upper | integer | - | Upper data value in the search range. |
Selects the type of IIC information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | RESTart | ADDRess | ANACk | NACKnowledge | READEprom | READ7 | WRITE7 | R7Data2 | W7Data2 | Type of IIC information to search for. |
Specifies address values when searching for IIC events. To set don't care values, use the integer -1.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Address value to set; may be an integer or a string in the form "0xnn". |
Specifies data values when searching for IIC events. Use the integer -1 to set don't care values; for IIC EEPROM data read events, the data value qualifier is set with :SEARch:SERial:IIC:QUALifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Data value to search for; may be an integer or a string in the form "0xnn". |
Specifies the second data value when searching for IIC events with two data values. Use the integer -1 to set don't care values.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Second data value to search for; may be an integer or a string of the form "0xnn". |
Specifies the data value qualifier used when searching for IIC EEPROM data read events. The query returns the current data value qualifier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | LESSthan | GREaterthan | Selects the data value qualifier used for IIC EEPROM data read event searches. |
Specifies the frame ID value when searching for LIN events. The query returns the current frame ID setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 63 | Frame ID value to use for LIN event search. |
Selects the type of LIN information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ID | DATA | ERRor | FRAMe | FSIGnal | Type of LIN information to search for in the Lister display. |
Sets the LIN pattern data value used when searching for LIN events. The numeric base is determined by :SEARch:SERial:LIN:PATTern:FORMat, and don't care values are only allowed when the format is HEX.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data value to search for. |
Specifies the length of the data value when searching for LIN events. The data value itself is set using :SEARch:SERial:LIN:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Length of the data value in NR1 format. |
Specifies the number base used with the :SEARch:SERial:LIN:PATTern:DATA command. The query returns the current number base setting.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | HEX | DECimal | Number base used for the search pattern data. |
Specifies the message to search for when LIN symbolic data has been loaded into the oscilloscope and LIN serial search mode is set to FRAMe or FSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string specifying the message to search for. |
Specifies the LIN symbolic signal to search for when LIN symbolic data has been loaded into the oscilloscope and the LIN serial search mode is set to FSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string naming the signal to search for. |
Specifies the signal value to search for when LIN symbolic data has been loaded into the oscilloscope and the LIN serial search mode is set to FSIGnal. Encoded signal values are not supported in the remote interface.
| Name | Type | Values | Description |
|---|---|---|---|
| data | real | - | Signal value to search for, in NR3 format. |
Selects the type of MIL-STD-1553 information to find in the Lister display. In RTA or RTA11 mode, the Remote Terminal Address is specified with :SEARch:SERial:M1553:RTA; in RTA11 mode, the additional 11 bits are specified with :SEARch:SERial:M1553:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | DSTArt | CSTArt | RTA | RTA11 | PERRor | SERRor | MERRor | Selects the MIL-STD-1553 search mode. |
:SEARch:SERial:M1553:MODE <value> :SEARch:SERial:M1553:MODE?
Specifies the additional 11 bits used when searching for the MIL-STD-1553 Remote Terminal Address + 11 Bits.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string of additional 11 bits. |
Sets the Remote Terminal Address (RTA) value used when searching for MIL-STD-1553 events. The query returns the current RTA setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 31 | 5-bit Remote Terminal Address value in decimal, hexadecimal, binary, or string form. |
Specifies the status and data nibbles to be searched for when the FCData search mode is chosen.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex-like string in the form "0xn..." where n is 0-9, A-F, X, or $. |
Sets what SENT serial decode search mode to use when SENT serial decode is turned on and displayed in the Lister. The mode selects whether to search for Fast Channel data, Slow Channel Message IDs, Slow Channel data and IDs, CRC errors, or pulse period errors.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FCData | SCMid | SCData | CRCerror | PPERror | Search mode to use for SENT serial decode. |
Specifies the data to search for in the Slow Channel Message ID and Data search mode.
| Name | Type | Values | Description |
|---|---|---|---|
| data | integer | -1 - 65535 | Slow channel data search value. |
Specifies the ID to search for in the Slow Channel Message ID and Slow Channel Message ID & Data trigger modes. The ID can be set from -1 (don't care) to 255, depending on the message length.
| Name | Type | Values | Description |
|---|---|---|---|
| id | integer | -1 - 255 | ID to search for. |
Specifies whether SPI search is performed on the MOSI data or the MISO data. Data values are specified using :SEARch:SERial:SPI:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MOSI | MISO | Selects whether the SPI search uses MOSI or MISO data. |
Sets the SPI pattern data value used when searching for SPI events. The data width is set by :SEARch:SERial:SPI:PATTern:WIDTh.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | SPI pattern data value in the form "0xnn...n". |
:SEARch:SERial:SPI:PATTern:DATA <string> :SEARch:SERial:SPI:PATTern:DATA?
Specifies the width of the SPI data value, in bytes, when searching for SPI events. The data value is specified using :SEARch:SERial:SPI:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 1 - 10 | Width of the SPI data value in bytes. |
Sets the UART/RS232 data value used when searching for events. The value qualifier is specified with :SEARch:SERial:UART:QUALifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | 8-bit data value in decimal, hexadecimal, binary, or quoted string format. |
Selects the type of UART/RS232 information to find in the Lister display. The setting chooses among receive data, transmit data, parity error, or any error search modes.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | RDATa | RD1 | RD0 | RDX | TDATa | TD1 | TD0 | TDX | PARityerror | AERRor | Specifies the UART/RS232 search mode. |
Specifies the data value qualifier used when searching for UART/RS232 events. The query returns the current qualifier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | GREaterthan | LESSthan | Selects the data value qualifier. |
Specifies the USB search mode. The query returns the specified USB search mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TOKen | DATA | HANDshake | SPECial | ALLerrors | PIDerror | CRC5error | CRC16error | GLITcherror | STUFFerror | SE1error | USB search mode to use. |
Specifies the 7-bit Address portion of the search value, in hex. The query returns the specified Address portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex address string of the form "0xnn". |
Specifies the CRC portion of the USB serial search value, in hex.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CRC value formatted as "0xnn". |
Sets the Data portion of the search value in hex. The query returns the specified Data portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex string value in the form "0xn..." where n is 0-9, A-F, X, or $. |
Specifies the USB serial search data length in bytes. The query returns the specified data length.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 20 | Data length in bytes. |
Sets the 4-bit Endpoint portion of the USB search value, in hex. The query returns the specified Endpoint portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 4-bit Endpoint portion of the search value, formatted as "0xn". |
Specifies the 2-bit ET portion of the search value, in hex. The query returns the specified ET portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex ET portion of the search value, formatted as "0xn" where n is one of 0, 1, 2, 3, X, or $. |
Sets the 11-bit Frame portion of the USB serial search value, in hex. The query returns the specified Frame portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex frame value in the form "0xnnn". |
Specifies the 7-bit Hub Address portion of the search value, in hex. The query returns the specified Hub Address portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex string in the form "0xnn" where n is 0-9, A-F, X, or $. |
Specifies the USB data PID to find for serial USB search. The DATA USB search mode is selected using :SEARch:SERial:USB:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | DATA0 | DATA1 | DATA2 | MDATa | USB data PID to find. |
:SEARch:SERial:USB:PID:DATA <pid> :SEARch:SERial:USB:PID:DATA?
Specifies the USB handshake PID to find. The HANDshake USB search mode is selected using :SEARch:SERial:USB:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | ACK | NAK | STALl | NYET | USB handshake PID to find. |
Specifies the USB special PID to search for. The special USB search mode is selected using :SEARch:SERial:USB:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | PING | PRE | ERR | SPLit | Specifies the USB special PID to find. |
Specifies the USB token PID to find. The TOKen USB search mode is selected using :SEARch:SERial:USB:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | OUT | IN | SETup | SOF | USB token PID to search for. |
Specifies the 7-bit Port portion of the search value in hex. The query returns the specified Port portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 7-bit Port portion of the search value, formatted as hex string "0xnn". |
Specifies the 1-bit SC portion of the search value, in hex. The query returns the specified SC portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex search value in the form "0xn" where n is one of 0, 1, X, or $. |
Specifies the 2-bit S and E or U portion of the USB search value in hex. The query returns the specified portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex-encoded search value portion, formatted as "0xn" where n is one of 0, 1, 2, 3, X, or $. |
Sets the instrument date. The command performs validity checking to ensure the date is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| date | string | - | Date value in <year>,<month>,<day> format. |
Returns the oscilloscope's Host ID as part of a quoted ASCII string. The exact format is product-specific, and portable programs should not parse the contents; use *IDN? for a defined portable format instead.
:SYSTem:DIDentifier?
Writes a quoted ASCII string to a text box on-screen. Use `:SYSTem:DSP ""` to remotely remove the message from the display.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string displayed in the on-screen text box, up to 75 characters. |
:SYSTem:DSP <string> :SYSTem:DSP ""
Returns the next error number and error text from the error queue. Repeated queries return errors in first-in, first-out order until the queue is empty, after which zero is returned until another error occurs.
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 |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns front panel lock on or off. |
Sets the manufacturer string portion of the identification string returned by *IDN?. The query form returns the currently set manufacturer string.
| Name | Type | Values | Description |
|---|---|---|---|
| manufacturer_string | string | - | Quoted ASCII string identifying the manufacturer, up to 63 characters. |
Sets the manufacturer string to "KEYSIGHT TECHNOLOGIES".
Places the instrument in a known default state, the same as pressing the front-panel Default Setup key. It resets many acquisition, channel, display, time base, and trigger settings, but leaves some user preferences unchanged; use *RST to restore all user settings to factory defaults.
Disables or enables the 50 ohm impedance setting for all analog channels. Be careful when turning it on because there is no front-panel visual indication other than the disabled 50 Ω channel input impedance selection.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns analog channel protection lock on or off. |
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 how the log file is written. |
Specifies whether remote command logging is written to a text file, to the screen, or to both. If the destination is changed while remote command logging is running, logging is turned off.
| 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, if applicable.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets whether remote command logging is shown on the screen. |
Specifies the remote command log file name. Because log files are ASCII text files, the ".txt" extension is automatically added to the name specified.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Quoted ASCII string containing the remote command log file name. |
Enables or disables remote command logging. The query returns the current 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. The query returns the current transparent screen display background setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the transparent screen display background setting. |
Sets 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 the binary 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 containing the instrument setup to restore. |
Sets or queries the system time in 24-hour format. Commas are used as separators, and validity checking is performed to ensure the time is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| time | string | - | Hours, minutes, and seconds in NR1 format. |
Disables or enables the touchscreen. The query returns the touchscreen's on/off status.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns the touchscreen on or off. |
Changes the front panel softkey menu.
| Name | Type | Values | Description |
|---|---|---|---|
| menu | enum | MASK | MEASure | SEGMented | LISTer | POWer | Selects the front panel softkey menu. |
Sets the current time base mode. The available modes are MAIN, WINDow, XY, and ROLL.
| 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. This command is an alias for :TIMebase:DELay.
| Name | Type | Values | Description |
|---|---|---|---|
| pos | real | s | Time in seconds from the trigger to the display reference, in NR3 format. |
Sets the full-scale horizontal time for the main window. The range is 10 times the current time-per-division setting.
| 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.
Enables or disables the 10 MHz REF BNC on the rear panel. ON sets the reference signal mode to IN; OFF disables the BNC and is equivalent to setting the mode to OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Enables or disables the 10 MHz REF BNC. |
:TIMebase:REFClock ON :TIMebase:REFClock OFF
Sets the time reference for the main window display. The reference can be placed at the left, center, right, or a custom location via the related location command.
| Name | Type | Values | Description |
|---|---|---|---|
| reference | enum | LEFT | CENTer | RIGHt | CUSTom | Selects the time reference position. |
myScope.WriteString ":TIMebase:REFerence CENTer" ' Set reference to center.
Sets the time reference location as a percent of the graticule width. This command is used when :TIMebase:REFerence is set to CUSTom.
| Name | Type | Values | Description |
|---|---|---|---|
| loc | real | 0.0 - 1.0 | Percent of the graticule width where the time reference location is placed. |
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/div | Time per division for the main window, expressed 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 time base control's vernier setting. |
Sets the horizontal position in the zoomed (delayed) view of the main sweep. The value must keep the zoomed view window within the main sweep range.
| Name | Type | Values | Description |
|---|---|---|---|
| pos value | real | s | Time from the trigger event to the zoomed (delayed) view reference point, in NR3 format. |
Sets the full-scale horizontal time for the zoomed (delayed) window in seconds. The 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 | one half of the :TIMebase:SCALe value | Scale value in seconds, in NR3 format. |
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 components 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 in seconds. Holdoff prevents additional triggers until a specified time has passed since the last trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| holdoff_time | real | 40 ns - 10 s | Holdoff time value in NR3 format. |
Specifies the maximum trigger holdoff time when random trigger holdoff mode is enabled. The query returns the maximum random trigger holdoff time setting.
| Name | Type | Values | Description |
|---|---|---|---|
| max_holdoff | real | s | Maximum holdoff time in seconds, in NR3 format. |
Specifies the minimum trigger holdoff time when random trigger holdoff mode is enabled. The query returns the minimum random trigger holdoff time setting.
| Name | Type | Values | Description |
|---|---|---|---|
| min_holdoff | real | s | Minimum holdoff time in seconds, in NR3 format. |
Enables or disables random trigger holdoff mode. When enabled, the holdoff time is randomized from one acquisition to the next between the values set by :TRIGger:HOLDoff:MINimum and :TRIGger:HOLDoff:MAXimum.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables random trigger holdoff mode. |
Automatically sets the trigger levels of all displayed analog channels to their waveforms' 50% values. If AC coupling is used, the trigger levels are set to 0 V; when dual trigger levels are in use, the command has no effect.
Sets the high trigger voltage level for the specified source. High and low trigger levels are used with runt triggers and rise/fall time (transition) triggers.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | V | High trigger voltage level; for internal triggers, the manual states it as 0.75 x full-scale voltage from center screen in NR3 format. |
| source | enum | CHANnel<n> | Trigger source channel number, with n from 1 to the number of analog channels. |
Sets the low trigger voltage level for the specified source. High and low trigger levels are used with runt triggers and rise/fall time (transition) triggers.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | V | Low trigger voltage level, specified as 0.75 x full-scale voltage from center screen in NR3 format for internal triggers. |
| source | enum | CHANnel<n> | Trigger source channel. |
Selects the trigger mode (trigger type). The query returns the current trigger mode; if :TIMebase:MODE is ROLL or XY, it returns "NONE".
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | EDGE | GLITch | PATTern | TV | DELay | EBURst | OR | RUNT | SHOLd | TRANsition | SBUS{1 | 2} | 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 oscilloscope; the command is not valid in TV trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 0 | OFF | 1 | ON | Sets the noise reject filter mode. |
Selects the trigger sweep mode. AUTO displays a baseline in the absence of a signal, while NORMal stops sweeping when no trigger is present.
| Name | Type | Values | Description |
|---|---|---|---|
| sweep | enum | AUTO | NORMal | Trigger sweep mode. |
Sets the arming edge slope for the Edge Then Edge trigger to rising or falling. The query returns the current arming edge slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Arming edge slope for the trigger. |
Selects the input used for the arming edge in the Edge Then Edge trigger. The query returns the current arming edge source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Input source for the arming edge, either an analog channel or a digital channel. |
Sets the delay time between the arming edge and the trigger edge in the Edge Then Edge trigger. The time is specified in seconds and must be from 4 ns to 10 s.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 4 ns - 10 s | Time in seconds in NR3 format. |
Sets the Nth edge of the trigger source to trigger on. The query returns the current Nth trigger edge setting.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Nth trigger edge setting in NR1 format. |
Specifies the trigger edge slope for the Edge Then Edge trigger. Use NEGative for a falling edge or POSitive for a rising edge.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the trigger edge slope. |
Selects the input used for the trigger edge in the Edge Then Edge trigger. The query returns the current trigger edge source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Source channel for the trigger edge. |
Sets the Nth edge at the burst edge counter resource, which is used in the trigger stage to determine which edge in a burst generates a trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Nth edge setting for the burst edge counter. |
Sets the Nth edge in a burst idle resource in seconds. The timer is used to set the minimum time before the next burst.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 10 ns - 10 s | Time in seconds in NR3 format. |
Sets whether the rising edge or falling edge of the Nth edge in a burst generates a trigger. The query returns the current burst-edge slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the burst-edge slope used to generate the trigger. |
Selects the input that produces the Nth edge burst trigger. The query returns the current Nth edge burst trigger source; if all channels are off, it returns "NONE".
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input source for the Nth edge burst trigger. |
Sets the input coupling for the selected trigger sources. The coupling can be AC, DC, or LFReject; the corresponding query returns the current coupling selection.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | AC | DC | LFReject | Input coupling selection for the trigger path. |
Sets the trigger level voltage for the active trigger source. If an optional source is specified and is not the active source, only that source's level is affected and the active source is not changed.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | V | Trigger level voltage, specified in NR3 format; the manual states 0.75 times full-scale from center screen for internal triggers, ±(external range setting) for external triggers, and ±8 V for digital channels on MSO models. |
| sourceopt | enum | CHANnel<n> | EXTernal | DIGital<d> | Optional trigger source to which the level applies. |
Turns the low-frequency or high-frequency reject filter on or off for edge triggering. Only one of these filters can be on at a time, and the reject setting is coupled with :TRIGger[:EDGE]:COUPling.
| Name | Type | Values | Description |
|---|---|---|---|
| reject | enum | OFF | LFReject | HFReject | Selects the reject filter state. |
Specifies the slope of the edge trigger. The command is not valid in TV trigger mode; use :TRIGger:TV:POLarity instead.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | ALTernate | Selects the trigger edge slope. |
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"
Selects the input source that produces the trigger. For the query, returns the current source; if all channels are off, it returns "NONE".
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | LINE | WGEN | WGEN1 | WGEN2 | WMOD | Selects the trigger input source for DSO models. |
:TRIGger:EDGE:SOURce CHANnel1
Sets the minimum pulse width duration for the selected :TRIGger:GLITch:SOURce. The query returns that minimum pulse width duration time.
| Name | Type | Values | Description |
|---|---|---|---|
| greater_than_time | real | s | Minimum pulse width duration in NR3 floating-point format. |
Sets the maximum pulse width duration for the selected :TRIGger:GLITch:SOURce. The query returns the pulse width duration time for :TRIGger:GLITch:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | - | 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 | .75 x full-scale voltage from center screen | Trigger level voltage. |
| sourceopt | enum | CHANnel<n> | EXTernal | DIGital<d> | Trigger source channel or external input, depending on model. |
Sets the polarity for the glitch pulse width trigger. The query returns the glitch pulse width trigger polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Polarity to use for the glitch pulse width trigger. |
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 glitch pulse width trigger qualifies as greater than, less than, or within a range. |
Sets the pulse width duration range for the selected :TRIGger:GLITch:SOURce. The two time values may be entered in any order; the smaller value becomes <greater_than_time> and the larger value becomes <less_than_time>.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | 15 ns - 10 seconds | Upper pulse-width time limit. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower pulse-width time limit. |
Selects the channel that produces the pulse width trigger. The query returns the current pulse width source, or "NONE" if all channels are off.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | DIGital<d> | CHANnel<n> | Channel that produces the pulse width trigger. |
Specifies the edges to include in the OR'ed edge trigger. Each bit in the string corresponds to a channel, using R, F, E, or X to define the edge selection.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Edge-selection string in which each character corresponds to a channel. |
Specifies the channel values to be used in the pattern trigger. The optional edge source and edge parameters may be sent together with the pattern string when using HEX format, and take precedence if used.
| Name | Type | Values | Description |
|---|---|---|---|
| pattern | string | - | Pattern string defining channel values; format depends on :TRIGger:PATTern:FORMat (ASCII or HEX). |
| edge_sourceopt | enum | CHANnel<n> | DIGital<d> | NONE | Optional source channel for the specified edge. |
| edgeopt | enum | POSitive | NEGative | Optional edge polarity to use with the edge source. |
Sets the entry and query number base used by :TRIGger:PATTern. The default base is ASCii.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Number base used for pattern trigger pattern entry and query. |
Sets the minimum duration for the defined pattern when :TRIGger:PATTern:QUALifier is GREaterthan, and sets the timeout value when :TRIGger:PATTern:QUALifier is TIMeout.
| Name | Type | Values | Description |
|---|---|---|---|
| greater_than_time | real | s | Minimum trigger duration in seconds, entered in NR3 format with an optional time suffix. |
Sets the maximum duration for the defined pattern when :TRIGger:PATTern:QUALifier is set to LESSthan. The query returns the duration time for the defined pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | s | Maximum trigger duration in NR3 format. |
Qualifies when the trigger occurs for a pattern trigger. Use the query form to return the current trigger duration qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | ENTered | GREaterthan | LESSthan | INRange | OUTRange | TIMeout | Selects the trigger duration qualifier. |
Sets the duration for the defined pattern when :TRIGger:PATTern:QUALifier is set to INRange or OUTRange. The two time parameters may be entered in any order; the smaller value becomes <greater_than_time> and the larger value becomes <less_than_time>.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | 15 ns - 10 seconds | Upper time bound for the defined pattern duration. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower time bound for the defined pattern duration. |
Sets the polarity for the runt trigger. The query returns the current runt trigger polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | EITHer | Runt trigger polarity to use. |
Selects the qualifier used for specifying runt pulse widths. For the query, returns the current runt trigger qualifier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | NONE | Selects how runt pulse width is compared against :TRIGger:RUNT:TIME. |
Selects the channel used to produce the runt trigger. The query returns the current runt trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel used to produce the trigger. |
Sets the runt pulse qualifier time used with :TRIGger:RUNT:QUALifier when triggering on runt pulses whose width is greater than or less than a certain value. The query returns the current runt pulse qualifier time setting.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | s | Time value in floating-point NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional unit suffix for the time value. |
Specifies whether the rising edge or falling edge of the clock signal is used.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the edge used for triggering. |
Selects the input channel probing the clock signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input channel source for the clock signal. |
Selects the input channel probing the data signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Data signal source channel. |
Sets the trigger hold time. The query returns the currently specified hold time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Hold time value in NR3 floating-point format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Sets the trigger hold time setup value. 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 unit suffix. |
Specifies whether the trigger looks for rise/fall times greater than or less than a set time value. The time value is set with :TRIGger:TRANsition:TIME.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | Selects whether the trigger condition is greater than or less than the specified time value. |
Specifies whether the trigger transition uses a positive rising edge or a negative falling edge. The query returns the current rise/fall time trigger slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the trigger slope polarity. |
Selects the channel used to produce the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel used to produce the trigger. |
Sets the time value for rise/fall time triggers. Use :TRIGger:TRANsition:QUALifier to specify whether triggering occurs on times greater than or less than this value.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | s | Time value for the rise/fall time trigger. |
| suffixopt | enum | s | ms | us | ns | ps | Optional unit suffix for the time value. |
Sets the TV trigger to occur on a specific video line. The allowed line number range depends on the TV standard and mode.
| Name | Type | Values | Description |
|---|---|---|---|
| line_number | integer | 1 - 1024 | TV trigger line number in NR1 integer format. |
:TRIGger:TV:LINE <line_number> :TRIGger:TV:LINE?
Selects the TV trigger mode and field. The LALTernate mode is not available when :TRIGger:TV:STANdard is GENeric.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FIEld1 | FIEld2 | AFIelds | ALINes | LINE | LFIeld1 | LFIeld2 | LALTernate | TV trigger mode and field. |
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 | enum | CHANnel<n> | Channel used as the TV trigger source. |
Selects the TV trigger video standard. Supported standards include NTSC, PAL, PAL-M, SECAM, and, with the extended Video triggering license, additional EDTV/HDTV standards.
| Name | Type | Values | Description |
|---|---|---|---|
| standard | enum | GENeric | NTSC | PALM | PAL | SECam | P480L60HZ | P480 | P720L60HZ | P720 | P1080L24HZ | P1080 | P1080L25HZ | P1080L50HZ | P1080L60HZ | I1080L50HZ | I1080 | Video standard to use for TV triggering. |
Specifies the Generic video trigger's Nth edge to trigger on after synchronizing with the vertical sync.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Edge number in NR1 format. |
Enables or disables the horizontal sync control in the Generic video trigger. For interleaved or progressive video with tri-level sync, enabling HSYNc can help the ENUMber function count only lines instead of double-counting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables the horizontal sync control. |
Sets the minimum time the horizontal sync pulse must be present to be considered valid when Generic video trigger horizontal sync control is enabled. The query returns the horizontal sync time setting.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | s | Seconds in NR3 format. |
Specifies the "greater than the sync pulse width" time in the Generic video trigger, allowing oscilloscope synchronization to the vertical sync. The query returns the current setting.
| Name | Type | Values | Description |
|---|---|---|---|
| min_time | real | s | Seconds value in NR3 format for the minimum time threshold. |
Sets the analog source channel shared by all zones. The query returns the analog source channel specified for zone qualified triggers.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog source channel to use for all zones. |
Enables or disables the zone qualified trigger feature. When the feature is on, the zone(s) are actively used to qualify the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 0 | OFF | 1 | ON | Turns zone qualified trigger on or off. |
Sets the zone qualifying condition for Zone 1 or Zone 2 as either "Must Intersect" or "Must Not Intersect".
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INTersect | NOTintersect | Selects the zone qualifying condition. |
Sets the size and location of Zone 1 or Zone 2. The query returns the current size and location of the selected zone.
| Name | Type | Values | Description |
|---|---|---|---|
| width | real | s | Width of the zone in seconds. |
| height | real | V | Height of the zone in volts. |
| x_center | real | s | Center of the zone in seconds. |
| y_center | real | V | Center of the zone in volts. |
Queries the validity of Zone 1 or Zone 2. Zone 2 can return INValid if the zones overlap with opposing qualifying conditions, or OSCReen if the zone is off-screen.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Zone number in NR1 format. |
Sets the state for Zone 1 or Zone 2. When a zone's state is on and Zone Trigger is on, that zone is actively used to qualify the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 0 | OFF | 1 | ON | Turns the specified zone on or off. |
Sets the trigger threshold for a pod of 8 digital channels. The threshold can be set to a predefined value or a user-defined voltage; for predefined values, the voltage parameter is not required.
| Name | Type | Values | Description |
|---|---|---|---|
| channel group | enum | POD1 | POD2 | Selects the pod whose threshold is being set. |
| threshold type | enum | CMOS | ECL | TTL | USERdef | Selects a predefined threshold or a user-defined threshold. |
| valueopt | real | Volt | Voltage for USERdef. |
Sets the TV trigger mode and field. This obsolete command is provided for compatibility; use :TRIGger:TV:MODE instead.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERtical | Selects the TV trigger mode and field. |
Sets the output sequence of the WORD data. It affects transmitting sequence 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. |
:WAVeform:BYTeorder <value> :WAVeform:BYTeorder?
Returns the count used to acquire the current waveform. For all acquisition types except average, this value is 1.
Returns the binary block of sampled data points as IEEE 488.2 arbitrary block data. The data format follows the current :WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and :WAVeform:SOURce settings, and the number of points is controlled by :WAVeform:POINts.
myScope.WriteString ":WAV:DATA?"
Sets the data transmission mode for waveform data points. The format determines how waveform data are transferred; ASCii is required for serial decode bus sources, and ASCii or WORD are allowed for digital channel bus sources.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | WORD | BYTE | ASCii | Data transmission format for waveform data. |
Sets the desired number of waveform points to be transferred with :WAVeform:DATA?. The command accepts either an integer point count or the deprecated points mode keywords NORMal, MAXimum, or RAW.
| Name | Type | Values | Description |
|---|---|---|---|
| wfm_points | numeric | 100 - 10000000 | Requested number of waveform points, or a deprecated points mode keyword. |
| mode | enum | NORMal | MAXimum | RAW | Deprecated waveform points mode option. |
:WAVeform:POINTS 1000
Sets the waveform points mode used for data transferred by :WAVeform:DATA?. The mode selects the measurement record, raw acquisition record, or the record with the maximum number of points.
| Name | Type | Values | Description |
|---|---|---|---|
| points_mode | enum | NORMal | MAXimum | RAW | Selects which record is used for waveform data transfer. |
Requests the preamble information for the selected waveform source. The preamble contains the vertical and horizontal scaling information for the corresponding channel's data.
:WAVeform:PREamble?
Enables or disables the waveform data for all segments setting. When ON, :WAVeform:DATA? returns data for all segments; when OFF, it returns data for the current segment.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether waveform data for all segments is enabled or disabled. |
Returns the number of memory segments in the acquired data. The query can be used while segments are being acquired.
Returns the time tag of the currently selected segmented memory index. The index is selected using :ACQuire:SEGMented:INDex.
Returns X (time) information for all waveform segments at once. The <xlist_type> option selects relative X-origin, absolute X-origin, or time tag information.
| Name | Type | Values | Description |
|---|---|---|---|
| xlist_type | enum | RELXorigin | ABSXorigin | TTAG | Selects which X-information is returned for each segment. |
Selects the analog channel, function, digital pod, digital bus, reference waveform, or serial decode bus used as the source for the :WAVeform commands. On MSO models, POD or BUS sources are available; when SBUS1 or SBUS2 is selected, only ASCII waveform format is allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | SBUS{1 | 2} | Selects the waveform source. |
:WAVEFORM:SOURCE CHAN1
Selects which serial-decode subsource is used for the current waveform source. For SBUS serial decode, it chooses among the available data sets; for non-SBUS sources, only SUB0 is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| subsource | enum | SUB0 | RX | MOSI | FAST | SUB1 | TX | MISO | SLOW | Chooses the waveform subsource to use. |
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 waveform data values are sent as unsigned or signed integers; it has no effect if the data format is ASCII.
| Name | Type | Values | Description |
|---|---|---|---|
| unsigned | enum | 0 | OFF | 1 | ON | Selects unsigned mode on or off. |
Sets the view setting associated with the currently selected waveform. MAIN shows the data in the oscilloscope's main waveform display area; ALL shows all captured data and is available only when Digitizer mode is on.
| Name | Type | Values | Description |
|---|---|---|---|
| view | enum | MAIN | ALL | View setting for the selected waveform. |
Returns the x-increment value for the currently specified source. This is the time difference between consecutive data points in seconds.
Returns the x-origin value for the currently specified source. XOrigin is the X-axis value of the data point specified by the :WAVeform:XREFerence value; in this product, it is always the first data point (XReference = 0).
Returns the x-reference value for the currently specified source. The x-reference point is the first displayed point and is always 0 in this product.
Returns the y-increment value in volts for the currently specified source. The y-increment is the voltage difference between consecutive data values; for digital waveforms it is always "1".
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.
Selects the byte order for binary transfers. The query returns the current byte order selection.
| Name | Type | Values | Description |
|---|---|---|---|
| order | enum | MSBFirst | LSBFirst | Byte order used for binary transfers. |
Downloads an arbitrary waveform in floating-point values format. The command accepts either IEEE 488.2 binary block data or comma-separated floating-point values between -1.0 and +1.0.
| Name | Type | Values | Description |
|---|---|---|---|
| binary | block | - | IEEE 488.2 binary block of floating-point values between -1.0 and +1.0. |
| value | real | -1.0 - +1.0 | Comma-separated floating-point value between -1.0 and +1.0. |
:WGEN1:ARBitrary:DATA 0.0, 0.5, 1.0, 0.5, 0.0, -0.5, -1.0, -0.5
Returns the number of points used by the current arbitrary waveform.
Clears the arbitrary waveform memory and loads it with the default waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output number in NR1 format. |
Downloads an arbitrary waveform using 16-bit integer DAC values.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output selector in NR1 format. |
| binary | integer | -512 - +511 | Decimal 16-bit integer values in IEEE 488.2 binary block format. |
| value | integer | -512 - +511 | Decimal integer values in comma-separated NR1 format. |
Enables or disables interpolation control for the arbitrary waveform on the selected WaveGen output. When ON, lines are drawn linearly between arbitrary waveform points; when OFF, line segments remain horizontal until the next point.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output index in NR1 format. |
| state | enum | 0 | OFF | 1 | ON | Turns interpolation off or on. |
Stores the selected source waveform into the arbitrary waveform memory.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | WMEMory<r> | FUNCtion<m> | MATH<m> | Source waveform to store. |
Sets the waveform generator frequency for all waveforms except Noise and DC. You can also specify the frequency indirectly using :WGEN<w>:PERiod.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output number in NR1 format. |
| frequency | real | Hz | Waveform frequency in NR3 format. |
Selects the waveform type for the specified WaveGen output. The query returns the currently selected signal type.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | SINusoid | SQUare | RAMP | PULSe | DC | NOISe | SINC | EXPRise | EXPFall | CARDiac | GAUSsian | ARBitrary | Waveform type to select. |
Sets the pulse width for Pulse waveforms. The pulse width can be adjusted from 20 ns to the period minus 20 ns.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output index in NR1 format. |
| width | real | 20 ns - period minus 20 ns | Pulse width in seconds in NR3 format. |
Sets the symmetry of the ramp waveform for the selected WaveGen output. Symmetry is the amount of time per cycle that the ramp waveform is rising.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | Symmetry percentage for the ramp waveform. |
Sets the square wave duty cycle for a WaveGen output. Duty cycle is specified as the percentage of the period that the waveform is high.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output number in NR1 format. |
| percent | real | 20 - 80 | Duty cycle percentage in NR1 format. |
Sets the amount of amplitude modulation for the waveform generator. The depth is specified as a percentage of the amplitude range used by the modulation.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | AM depth percentage. |
Specifies the frequency of the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency. |
Sets the frequency deviation for FM modulation of the selected waveform generator. The deviation is specified in Hz and cannot exceed the original carrier frequency; the carrier frequency plus deviation must also stay within the waveform generator's maximum frequency plus 100 kHz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Frequency deviation from the original carrier signal frequency. |
Specifies the frequency of the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency. |
Specifies the hop frequency 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. |
Specifies the FSK modulation rate, which controls the rate at which the output frequency shifts. The rate is a digital square-wave modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | FSK modulation rate in Hz. |
Specifies the shape of the modulating signal used for AM and FM modulation. For the RAMP shape, the ramp symmetry can be set with :WGEN<w>:MODulation:FUNCtion:RAMP:SYMMetry.
| Name | Type | Values | Description |
|---|---|---|---|
| shape | enum | SINusoid | SQUare | RAMP | Shape of the modulating signal. |
Sets the ramp waveform symmetry, i.e. the amount of time per cycle that the ramp waveform is rising. The query returns the current ramp symmetry percentage setting.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | Symmetry percentage. |
Adds noise to the currently selected waveform generator signal. The allowable percent range depends on the current amplitude because the total signal amplitude is limited by the regular amplitude limit.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0 - 100 | Percent 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 modulated waveform generator output. |
Selects the modulation type for the waveform generator. Supported types are AM, FM, and FSK.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | AM | FM | FSK | Modulation type to select. |
Sets whether the waveform generator signal output is ON or OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output number in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Turns the waveform generator signal output on or off. |
Selects the expected output load impedance for the specified waveform generator output. The query returns the current expected output load impedance.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
Specifies whether the defined waveform is output continuously or as a single cycle. The query returns the current output mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | SINGle | Selects continuous output or single-shot output. |
Specifies whether the waveform generator output is inverted. The query returns the specified output polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | NORMal | INVerted | Sets the output polarity. |
Causes a single cycle of the defined waveform to be output when single-shot output mode is selected. Sending the command multiple times interrupts a slow signal output before the cycle is completed.
Sets the waveform generator period for all waveforms except Noise and DC. The period can also be specified indirectly using :WGEN<w>:FREQuency.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output index in NR1 format. |
| period | real | s | Waveform period in seconds, formatted as NR3. |
Restores the waveform generator factory default settings: 1 kHz sine wave, 500 mVpp, 0 V offset.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output index in NR1 format. |
Enables or disables tracking of frequency, amplitude, offset, and duty-cycle adjustments for the specified waveform generator output. When tracking is enabled, the other generator's waveform selection must be in the same group, and tracked settings become unavailable for manual adjustment.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output number in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Turns tracking on or off. |
Sets whether amplitude tracking is enabled for the specified waveform generator output. When tracking is enabled, amplitude and offset adjustments on this output are tracked by the other waveform generator output, and tracked settings on the other generator become unavailable.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output index in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables amplitude tracking. |
Sets the other waveform generator output to be identical to this waveform generator output, except that either output shape may be inverted. If the selected signal is ARB, the ARB waveform is copied as well.
Turns frequency tracking for the selected waveform generator output on or off. When enabled, frequency adjustments on this output are tracked by the other waveform generator output.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | Waveform generator output number in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables frequency tracking. |
Sets the phase relationship of a frequency-tracked waveform generator output. The query returns the frequency-tracked waveform phase relationship setting.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output index in NR1 format. |
| phase | real | -360 - +360 | Phase relationship value in NR1 format. |
Sets the waveform amplitude for a WaveGen output. For all waveforms except DC, this command specifies the waveform's amplitude; use :WGEN<w>:VOLTage:OFFSet for the offset voltage or DC level.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output number in NR1 format. |
| amplitude | real | V | Waveform amplitude in volts, in NR3 format. |
Sets the waveform high-level voltage for WaveGen output <w> for all waveforms except DC. The corresponding query returns the currently specified high-level voltage.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output number in NR1 format. |
| high | real | V | High-level voltage in volts, in NR3 format. |
Specifies the waveform's low-level voltage for all waveforms except DC. Use :WGEN<w>:VOLTage:HIGH to specify the high-level voltage, or :WGEN<w>:VOLTage and :WGEN<w>:VOLTage:OFFSet to set levels indirectly.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output number in NR1 format. |
| low | real | V | Low-level voltage in volts, in NR3 format. |
Specifies the waveform's offset voltage or DC level. The query returns the currently specified waveform offset voltage.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | V | Offset voltage to set. |
Clears the specified reference waveform location.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Reference waveform location to clear. |
Turns the display of the specified reference waveform on or off. Only one reference waveform can be displayed at a time; enabling one automatically turns the other off.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Reference waveform location to control. |
| on_off | enum | 1 | ON | 0 | OFF | Display state to set for the reference waveform. |
Sets the label for a reference waveform. The label is also added to the non-volatile label list, replacing the oldest label if necessary.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - (# ref waveforms) | Reference waveform number, in NR1 format. |
| string | string | - | Quoted ASCII label string, 10 characters or less. |
Copies the analog channel or math function waveform to the specified reference waveform location. Math functions whose x-axis is not frequency can be saved as reference waveforms.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | Waveform source to copy into the reference waveform location. |
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 - # ref waveforms | Reference waveform number, from 1 to the number of reference waveforms. |
| skew | real | s | Skew time in seconds in NR3 format. |
Sets the value represented at center screen for the selected reference waveform. If the requested offset is outside the legal range, the instrument automatically adjusts it to the nearest legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Reference waveform index 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 are copied from the original source waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Reference waveform number, from 1 to the number of stored reference waveforms. |
| range | real | - | Vertical full-scale range value in NR3 format. |
Sets the vertical scale, in units per division, of the selected reference waveform. Legal values are copied from the original source waveform that was saved as the reference waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Selects the reference waveform number. |
| scale | real | - | Vertical units per division for the selected reference waveform. |
Clears the cumulative edge variables for the next activity query. This is an obsolete compatibility command; use :ACTivity instead.
Sets the label text for an analog or digital channel source. This obsolete compatibility command also adds the name to the label list when a channel is set.
| Name | Type | Values | Description |
|---|---|---|---|
| source_text | enum | CHANnel1 | CHANnel2 | DIGital<d> | Channel source to label. |
| string | string | - | Quoted ASCII label string. |
Sets the threshold for a group of channels to a predefined value or a user-defined voltage. The command is obsolete and provided for compatibility; use :POD<n>:THReshold or :DIGital<n>:THReshold instead.
| Name | Type | Values | Description |
|---|---|---|---|
| channel group | enum | POD1 | POD2 | Channel group to apply the threshold setting to. |
| threshold type | enum | CMOS | ECL | TTL | USERdef | Threshold preset or user-defined threshold selection. |
| valueopt | real | -6.0 - 6.0 | User-defined threshold voltage in NR3 format; ignored for predefined threshold types. |
Sets the skew between channels 1 and 2. This is an obsolete compatibility command; use :CHANnel<n>:PROBe:SKEW instead.
| Name | Type | Values | Description |
|---|---|---|---|
| skew value | real | -100 ns - +100 ns | Skew time value in NR3 format. |
Erases the screen. This is an obsolete command provided for compatibility with previous oscilloscopes; use :DISplay:CLEar instead.
Sets the math operation for the g(t) source used as input to transform or filter functions, if available. Source1 and source2 are selected with :FUNCtion:GOFT:SOURce1 and :FUNCtion:GOFT:SOURce2.
| Name | Type | Values | Description |
|---|---|---|---|
| operation | enum | ADD | SUBTract | MULTiply | Math operation applied to the g(t) source. |
Selects the first input channel for the g(t) source used as the input to transform or filter functions. The query returns the current selection.
| Name | Type | Values | Description |
|---|---|---|---|
| value | string | - | Channel selection in the form CHANnel<n>. |
Selects the second input channel for the g(t) source used as the input to transform or filter functions, if available.
| Name | Type | Values | Description |
|---|---|---|---|
| value | channel_list | - | Second input channel selection. |
Selects the source for function operations such as FFT, DIFF, and INT. This obsolete command is provided for compatibility with previous oscilloscopes; use :FUNCtion:SOURce1 instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | ADD | SUBTract | MULTiply | Source used for function operations. |
Turns the selected function on or off. This command is provided for backward compatibility; use :FUNCtion:DISPlay instead.
| Name | Type | Values | Description |
|---|---|---|---|
| view | enum | 1 | ON | 0 | OFF | Selects whether the function is turned on or off. |