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 DSOX6002A is Keysight's oscilloscope in the InfiniiVision 6000 X-Series family. Its SCPI remote-control interface exposes 1109 commands across 64 subsystems - 1107 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,109
Commands
1,107
Settable
2
Queries
64
Subsystems
SCPI
Verified
2026-07-16
All commands
Sets the bits in the Standard Event Status Enable Register. A 1 enables the corresponding Standard Event Status Register bit; 0 disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask_argument | integer | 0 - 255 | Mask value used to enable or disable bits in the Standard Event Status Enable Register. |
Returns the contents of the Standard Event Status Register as an integer bit-weight value. Reading the register clears it.
Identifies the instrument type and software version.
Returns the current state of the instrument as a valid command string that can be used later to restore instrument settings. The result is similar to :SYSTem:SETup? but includes ":SYST:SET " before the binary block data.
Sets the operation complete bit in the Standard Event Status Register when all pending device operations have finished. The *OPC? query returns ASCII "1" 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.
Restores the state of the instrument from the specified save/recall register.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 9 | Specifies the save/recall register number to recall. |
Places the instrument in a known factory-default state. It is the same as using the front-panel Factory Default setup; for the equivalent of Default Setup with some user settings preserved, use :SYSTem:PRESet.
*RST
Stores the current state of the instrument in a save register. The data parameter specifies the register where the data is saved.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 9 | Save register number. |
Sets the bits in the Service Request Enable Register. A one in the register enables the corresponding Status Byte Register bit; a zero disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | 0 - 255 | Mask value for the bits to be enabled in the Status Byte Register. |
Returns the current value of the instrument's status byte. The MSS bit is reported on bit 6 instead of the RQS bit.
Triggers an acquisition. It has the same effect as the :DIGitize command with no parameters.
Performs a self-test on the instrument and places the result in the output queue. A result of 0 indicates the test passed; any non-zero result indicates failure.
The *WAI command has no function in the oscilloscope, but is parsed for compatibility with other instruments.
*WAI
Clears the cumulative edge variables for the next activity query. The query returns whether there has been activity on the digital channels since the last 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 all input signals and sets the correct conditions to display the signals, equivalent to pressing the Auto Scale key. If one or more sources are specified, those sources are enabled and all others blanked before autoscale is performed.
| 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. |
:AUToscale myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key.
Specifies the acquisition mode that is set by subsequent :AUToscale commands. NORMal makes :AUToscale set the NORMal acquisition type and RTIMe mode, while CURRent keeps the current acquisition type and mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | NORMal | CURRent | Acquisition mode to apply on subsequent autoscale operations. |
Specifies which channels will be displayed on subsequent autoscale operations. When ALL is selected, all channels that meet the autoscale requirements are displayed; when DISPlayed is selected, only channels that are turned on are autoscaled.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ALL | DISPlayed | Selects which channels are used by subsequent autoscale operations. |
Turns fast debug auto scaling on or off. The Fast Debug option changes :AUToscale behavior to help make quick visual comparisons while maintaining channel coupling for oscillating signals.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables fast debug auto scaling. |
Turns off the specified source, such as a channel, math function, serial decode bus, or reference waveform location. If no parameter is supplied, it turns off all sources.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r> | HISTogram | CHANnel<n> | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r> | HISTogram | Source to blank. |
Specialized RUN command that acquires waveforms according to the current :ACQuire settings and stops when the acquisition is complete. If no argument is given, it acquires the currently displayed channels, or all channels if none are displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | Acquisition source to digitize. |
myScope.WriteString ":DIGitize CHANnel1"
Sets a mask in the Hardware Event Enable register. Setting bit 12 enables bit 12 in the Operation Status Condition Register 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 bits enables the corresponding mask test event conditions and may cause an SRQ interrupt.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 16-bit integer mask written to the Mask Test Event Enable register. |
Returns the integer value contained in the Mask Test Event Register and clears the register.
Sets a mask in the Operation Status Enable register. Any bit set to 1 enables the corresponding status event and can contribute to setting bit 7 in the Status Byte Register and generating an SRQ.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | 0 - 32767 | 15-bit integer mask written 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 mask in the Overload Event Enable Register and enables reporting of the Overload Event Register. If enabled, an overvoltage on a 50a9 input automatically switches the input to 1 Ma9 impedance.
| Name | Type | Values | Description |
|---|---|---|---|
| enable_mask | integer | - | 16-bit integer mask that enables overload and fault event reporting by channel. |
Returns the overload protection value stored in the Overload Event Register (OVLR). A "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 |
|---|---|---|---|
| optionsopt | enum | COLor | GRAYscale | PRINter0 | PRINter1 | BMP8bit | BMP | PNG | NOFactors | FACTors | One or more print options, repeated up to 5 times. |
Queries image data back over the bus for storage. The command is obsolete and provided only for compatibility with previous oscilloscopes; use :DISPlay:DATA instead.
| Name | Type | Values | Description |
|---|---|---|---|
| optionsopt | enum | COLor | GRAYscale | BMP8bit | BMP | Print options to apply to the image data query. |
Returns the oscilloscope run state. The state can be RUN, STOP, or SING.
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. For MSO models, the source may also be a digital channel, POD, or BUS.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r> | HISTogram | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | Source whose display state is queried. |
Stops the acquisition. This is the same as pressing the Stop key on the front panel.
Reads the Trigger Event Register. After the register is read, it is cleared; 1 indicates a trigger has occurred and 0 indicates it has not.
Turns on the specified channel, function, 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> | HISTogram | Source to display for DSO models. |
:VIEW CHANnel1 myScope.WriteString ":VIEW CHANnel1" ' Turn channel 1 on.
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 and affects the operation of :DIGitize. The only legal value is 100, meaning all time buckets must contain data before the acquisition is considered complete.
| Name | Type | Values | Description |
|---|---|---|---|
| complete | integer | 100 - 100 | Minimum completion criteria for an acquisition. |
myScope.WriteString ":ACQuire:COMPlete 100"
Sets the number of values to be averaged for each time bucket when acquisition type is AVERage. In AVERage mode, the count can be set from 2 to 65536; the command is deprecated for a count of 1.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 65536 | Number of values to be averaged for each time bucket. |
Sets the disable anti-alias mode of the oscilloscope. 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. |
Sets the oscilloscope acquisition mode. The available modes are RTIMe, MRTime, ETIMe, and SEGMented.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | RTIMe | MRTime | ETIMe | SEGMented | Acquisition mode to use. |
Returns the number of data points that the hardware will acquire from the input signal. The number of points acquired is not directly controllable; to set the number of points transferred from the oscilloscope, use :WAVeform:POINts.
Selects the 10 MHz reference signal mode for the oscilloscope. OFF disables the 10 MHz REF BNC connector, OUT synchronizes 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 | Sets the 10 MHz reference signal mode. |
Calculates measurement statistics and/or infinite persistence over all acquired segments. It corresponds to the front panel Analyze Segments softkey.
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, in NR1 format. |
Sets the index into the acquired memory segments. The current segmented memory index can be read back with the query form.
| Name | Type | Values | Description |
|---|---|---|---|
| index | integer | 1 - 1000 | Segment index to select, in NR1 format. |
Returns the current oscilloscope acquisition sample rate. The maximum possible sample rate is returned when the optional MAXimum qualifier is used.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifieropt | enum | MAXimum | Selects the maximum possible sample rate instead of the current value. |
Selects the acquisition type to be used by the oscilloscope. Supported types are normal, average, high-resolution, and peak detect.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NORMal | AVERage | HRESolution | PEAK | Acquisition type to set. |
myScope.WriteString ":ACQuire:TYPE NORMal"
Includes or excludes the selected bit in the definition for the specified bus. For the setter, 1/ON includes the bit and 0/OFF excludes it; valid only for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Selects whether the bit is included in or excluded from the bus definition. |
myScope.WriteString ":BUS1:BIT1 ON"
Includes or excludes selected digital channels in the definition of the specified bus. The command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| channel_list | channel_list | - | Digital channels affected by the command, expressed as a list or range of channel numbers. |
| display | enum | 1 | ON | 0 | OFF | Specifies whether the selected bits 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 n must be 1 or 2, attached as a suffix to BUS.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Defines the bus that is 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 | Sets whether the selected bus display is enabled or disabled. |
Sets the specified bus label to a quoted ASCII string, and adds the name to the label list. The label may be 10 characters or less; longer labels are truncated.
| Name | Type | Values | Description |
|---|---|---|---|
| quoted_string | string | - | Label string for the bus. |
myScope.WriteString ":BUS1:LABel 'Data'"
Defines the bits included and excluded in the selected bus according to a mask. Set mask bits to 1 to include them and 0 to exclude them; the command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | integer | - | 32-bit mask value in decimal, nondecimal, or quoted string form. |
Returns the date of the last calibration.
Saves a calibration label string in the instrument's non-volatile memory. The query returns the contents of the calibration label string.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string of up to 32 characters, not including the quotes. |
Sets the signal available on the rear-panel TRIG OUT BNC. The available sources are trigger pulses, mask test failure indication, or waveform generator sync output.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | TRIGgers | MASK | WAVEgen | WGEN1 | WGEN2 | Selects the TRIG OUT BNC source. |
Returns the rear-panel calibration protect (CAL PROTECT) button state. PROTected indicates calibration is disabled, and UNPRotected indicates calibration is enabled.
Starts the user calibration procedure.
Returns the summary results of the last user calibration procedure.
Returns the change in temperature since the last user calibration procedure.
Returns the time of the last calibration.
Returns a comma-delimited list of the hit ranges for each color bin. The first two values are the hit range for the color bin with the fewest hits, followed by the next color bin, and so on.
Enables or disables the display of the color grade key and levels. The query returns whether the display is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the color grade key and levels display state. |
Zeros the color grade counters.
Sets the color theme used by the color graded waveform display. The theme specifies seven colors representing ranges of counter values in the database.
| Name | Type | Values | Description |
|---|---|---|---|
| theme | enum | TEMPerature | INTensity | Color grade theme to use. |
Specifies the waveform on which to perform the color grade analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the waveform source for color grade analysis. |
Enables or disables the color grade waveform display.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether the color grade display is enabled or disabled. |
Sets the bandwidth limit value for channel <n> and turns on bandwidth limiting. The oscilloscope chooses the nearest available limit greater than or equal to the requested value.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Channel number. |
| limit | real | 20E6 - 3E9 | Requested bandwidth limit in NR3 format; available values depend on oscilloscope bandwidth, input impedance, and V/div setting. |
Enables or disables the bandwidth limit for channel n. If bandwidth limiting is currently OFF, turning it ON invokes the lowest possible bandwidth limit (20 MHz); if it is already ON, the ON command does not change the current setting.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables bandwidth limiting. |
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 | Sets the input coupling for the specified channel. |
Turns the display of the specified channel on or off. The query returns the current display setting for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| display value | enum | 1 | ON | 0 | OFF | Display state to set for the selected channel. |
Selects the input impedance setting for the specified analog channel. Legal values are ONEMeg (1 MΩ) and FIFTy (50 Ω).
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Input impedance setting for the specified analog channel. |
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 | Sets channel inversion state for the specified channel. |
| n | integer | 1 - # analog channels | Specifies the channel number in NR1 format. |
Sets the analog channel label to the quoted ASCII string that follows. Labels are limited to 32 characters and longer labels are truncated.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII label string for the channel. |
myScope.WriteString ":CHANnel1:LABel ""CAL 1""" ' Label ch1 "CAL 1". myScope.WriteString ":CHANnel2:LABel ""CAL2""" ' Label ch1 "CAL2".
Sets the vertical offset represented at the center of the screen for the selected channel. If the value is outside the legal range, it is automatically adjusted to the nearest legal value; the legal range depends on :CHANnel<n>:RANGe, :CHANnel<n>:SCALe, and probe attenuation settings.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Vertical offset value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix. |
Sets the probe attenuation factor for the selected channel. The attenuation may be from 0.001 to 10000; obsolete values X1, X10, X20, and X100 are also supported. For AutoProbe probes, the value cannot be changed from the sensed value.
| Name | Type | Values | Description |
|---|---|---|---|
| attenuation | real | 0.001 - 10000 | Probe attenuation ratio in NR3 format. |
:CHANnel1:PROBe 10
Sets the N275xA InfiniiMode probe's quick-action button mode for channel <n>. The query returns the current quick-action button setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | HEADlight | INFiniimode | RSTop | SINGle | CDISplay | AUToscale | FTRigger | QACTion | NACTion | NONE | Selects the probe quick-action button mode. |
Begins the probe degauss operation. This command is for the N7026A and N2893A probes only.
Sets the N275xA InfiniiMode probe's quick-action button mode for channel <n>. The query returns the current quick-action button setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | HEADlight | INFiniimode | RSTop | SINGle | CDISplay | AUToscale | FTRigger | QACTion | NACTion | NONE | Selects the probe quick-action button mode. |
Enables or disables External Scaling on the analog input channel. External Scaling can apply additional gain to the input channel to account for additional attenuators, adapters, etc., in the probing system.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Analog input channel number in NR1 format. |
| state | enum | 0 | OFF | 1 | ON | Enables or disables External Scaling. |
Sets the gain associated with External Scaling. The query returns the External Scaling gain setting.
| Name | Type | Values | Description |
|---|---|---|---|
| gain_factor | real | 0.0001 - 1000 | Gain factor for External Scaling. |
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. Measurement results, channel sensitivity, and trigger level reflect the selected units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units for the connected probe. |
Sets the analog channel probe head type and dB value for the selected channel. This command is valid only for the 113xA Series probes.
| Name | Type | Values | Description |
|---|---|---|---|
| head_param | enum | SEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | DSMA | DSMA6 | NONE | Probe head type and dB value to set. |
Returns the type of probe attached to the specified oscilloscope channel.
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 |
|---|---|---|---|
| n | integer | 1 - # analog channels | Channel number in NR1 format. |
| 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 channel <n>. The query returns the current mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | DIFFerential | DOFFset | SEA | SEB | CM | Probe mode to set. |
Sets the R-sense resistor value for the specified channel when using the N2820A high-sensitivity current probe with the N2825A user-defined R-sense head. The query returns the current R-sense resistor setting, or "INF" when no N2820A probe is attached.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 1 m - 1 M | R-sense resistor value in ohms, expressed in NR3 format. |
Sets the channel-to-channel probe skew factor for the specified analog channel. The skew can be adjusted from -100 ns to +100 ns to remove cable-delay errors between channels.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Specifies the analog channel number. |
| skew value | real | -100 ns - +100 ns | Sets the probe skew time in NR3 format. |
Sets the channel probe signal type to differential or single-ended for 113xA Series probes. This also determines whether :CHANnel<n>:OFFSet affects the probe amplifier or the channel amplifier.
| 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 Primary and Secondary cables. The other cable takes the opposite waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Selects the zoom setting. |
Clears (resets) the input overload protection for the specified analog channel. When an overload has been sensed on a 50 Ω input, the channel can be used again in 50 Ω mode after the protection is cleared and the impedance is reset to 50 Ω.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - # analog channels | Analog channel number in NR1 format. |
Defines the full-scale vertical axis of the selected channel. Legal values with 1:1 probe attenuation are from 8 mV to 40 V; if probe attenuation changes, the 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. |
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 |
|---|---|---|---|
| scale | real | - | Vertical units per division in NR3 format, optionally followed by a V or mV suffix. |
| suffixopt | enum | V | mV | Optional unit suffix for the scale value. |
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 to use for the connected probe. |
Specifies whether the selected channel's vernier (fine vertical adjustment) setting is on or off. The query returns the current vernier state.
| Name | Type | Values | Description |
|---|---|---|---|
| vernier value | enum | 1 | ON | 0 | OFF | Sets the channel vernier setting to on or off. |
Selects the input impedance setting for the specified channel. This command is obsolete and provided for compatibility with previous oscilloscopes; use :CHANnel<n>:IMPedance instead.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Sets the input impedance to 1 MΩ or 50 Ω for the specified channel. |
Sets or queries the probe sense mode for the specified channel. The setter is obsolete and provided for compatibility; the mode is internally controlled and cannot actually be set.
| Name | Type | Values | Description |
|---|---|---|---|
| pmode value | enum | AUTo | MANual | Probe sense mode value to send. |
Turns the display of the recovered clock on or off. Math function 1 is used to display the recovered clock.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns the recovered clock display off or on. |
Sets the clock recovery method. The method can be FIXed, FOPLl, SOPLl, or EXPLicit, with additional parameters depending on the selected method.
| Name | Type | Values | Description |
|---|---|---|---|
| method | enum | FIXed | FOPLl | SOPLl | EXPLicit | Selects the clock recovery method. |
Automatically sets up the oscilloscope for the selected signal quality test and USB compliance test packets. It sets horizontal scale and delay, analog channel scale and vertical offset, and trigger mode and 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 set 0 to 5 hubs; for Far-end test type, the number of hubs is set to 0.
| Name | Type | Values | Description |
|---|---|---|---|
| number | integer | 0 - 5 | Number of internal hubs. |
Runs the selected USB signal quality compliance test. The oscilloscope stops acquisitions, analyzes the data on screen, and displays the results; it can also be run while the scope is already stopped.
Specifies the analog input channel that probes the adjacent D+ or D- signal. For Device Full Speed Signal Quality, the channel probes the adjacent D+ signal; for Device Low Speed Signal Quality, it probes the adjacent D- signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel, specified as CHANnel<n> with n from 1 to the number of analog channels in NR1 format. |
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 selection. |
Specifies the analog input channel probing the D- signal. On 4-channel oscilloscopes, different channel pairs must be used for the D+ and D- signals to provide the maximum sample rate.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel used for the D- signal. |
Specifies the analog input channel that is probing the USB D+ signal. On 4-channel oscilloscopes, different channel pairs are required for the D+ and D- signals to maintain maximum sample rate.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel used for the D+ signal. |
Selects the type of USB signal quality test to perform. The available tests are device/host hi-speed, low-speed, and full-speed modes.
| Name | Type | Values | Description |
|---|---|---|---|
| test | enum | DHSS | HHSS | DLSS | HLSS | DFSS | HFSS | USB signal quality test type. |
Specifies the USB compliance test fixture connection type for a selected Hi-Speed test. Use DIFFerential for a differential probe or SINGleended for two single-ended SMA cables.
| Name | Type | Values | Description |
|---|---|---|---|
| connection | enum | SINGleended | DIFFerential | Selects the test fixture connection type. |
Selects whether a Hi-Speed test uses near-end or far-end test type. The query returns the selected test type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NEARend | FARend | Selects the test type. |
Returns the current counter value.
Enables or disables the counter feature. The query returns whether the counter is enabled or disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether the counter feature is enabled or disabled. |
Sets the counter mode to frequency, period, or totalize. The query returns the current counter mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FREQuency | PERiod | TOTalize | Counter mode to set. |
Sets the number of digits of resolution used for the frequency or period counter. Higher resolutions require longer gate times, which increase measurement time.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 3 - 10 | Number of digits of resolution in NR1 format. |
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 | Counter source to measure. |
Zeros the edge event counter.
Enables or disables totalizer gating. When enabled, the totalizer only counts edges when a second gating signal polarity is true.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables totalizer gating. |
Specifies the gating signal condition under which totalizer edges are counted. The gating signal is set with :COUNter:TOTalize:GATE:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | NEGative | FALLing | POSitive | RISing | Gating signal condition used for counting totalizer edges. |
Selects the analog channel that provides the totalizer gating signal. The query returns the current totalizer gating signal source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog channel used as the totalizer gating signal source. |
Specifies whether positive or negative edges are counted.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | FALLing | POSitive | RISing | Selects the slope specification used for counting edges. |
:COUNter:TOTalize:SLOPe <slope> :COUNter:TOTalize:SLOPe?
Selects the type of demo signal used by the instrument.
| 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 | JITTer | DCMotor | RTEYe | SJITter | HARMonics | COUPling | CFD | SENT | USBPd | KEYSight | Specifies which demo signal function to output. |
:DEMO:FUNCtion SINusoid
Specifies the phase shift of the second sine waveform for the phase shifted sine demo signals. The query returns the currently set phase shift.
| Name | Type | Values | Description |
|---|---|---|---|
| angle | real | 0 - 360 | Phase shift angle in degrees, formatted in NR3. |
Specifies whether the demo signal output is ON (1) or OFF (0). The query returns the current state of the demo signal output setting.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Sets the demo signal output state. |
Turns the digital display on or off for the specified digital channel. This command is only valid for the MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Specifies the digital channel number in NR1 format. |
| display | enum | 1 | ON | 0 | OFF | Sets whether the digital display is enabled or disabled. |
Sets the label for the specified digital channel to the quoted ASCII string that follows. The label is also added to the non-volatile label list, replacing the oldest entry if needed. Querying 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 | - | Label text, 10 or fewer quoted ASCII characters. |
Sets the position of the specified digital channel. Bottom positions may be invalid depending on whether digital buses, serial decode waveforms, or the zoomed time base are displayed; valid only for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel index in NR1 format. |
| position | integer | - | Position to set for the specified channel. |
Sets the size of the digital channels on the display. The size is applied to all digital channels, so setting one digital channel sets them all. This command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | SMALl | MEDium | LARGe | Specifies the digital channel display size. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| d | integer | 0 - # digital channels - 1 | Digital channel index in NR1 format. |
| value | enum | CMOS | ECL | TTL | Sets the threshold to a preset logic level or to a user-defined threshold value with optional suffix. |
:DIGital<d>:THReshold <value> :DIGital<d>:THReshold?
Turns annotation on and off for annotation <n>. When on, the annotation appears in the upper left corner of the oscilloscope display and can be used for documentation notes.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 1 | ON | 0 | OFF | Turns the annotation on or off. |
| n | integer | 1 - 10 | Annotation index in NR1 format. |
Sets the background mode of annotation <n>. The query returns the specified annotation background mode.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 10 | Annotation number in NR1 format. |
| mode | enum | OPAQue | INVerted | TRANsparent | Background mode for the annotation. |
Sets the annotation color for annotation number <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. |
Sets the annotation string for annotation n, up to 254 quoted ASCII characters. Use an empty string to clear the annotation text.
| 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. |
Turns the display's backlight off or on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Backlight state to set. |
Clears the display and resets all associated measurements. If the oscilloscope is stopped, all currently displayed data is erased; if it is running, the data for active channels and functions is erased and new data appears on the next acquisition.
Reads screen image data. You can choose BMP, BMP8bit, or PNG formats in color or grayscale. If no format or palette is specified, the image is returned in the front panel's selected image format, or BMP color if that selection is not an image format.
| Name | Type | Values | Description |
|---|---|---|---|
| formatopt | enum | BMP | BMP8bit | PNG | Image format to return. |
| paletteopt | enum | COLor | GRAYscale | Color or grayscale palette for the returned image. |
: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 setting. |
Sets the display graticule (grid) type. When TV trigger is selected and at least one channel is scaled to 140 mV/div, the available grid types are FULL, MVOLt, and IRE.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | FULL | MVOLt | IRE | Graticule type to display. |
Sets the waveform intensity, equivalent to adjusting the front panel Intensity knob. The query returns the current 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 | Enables or disables the display of analog and digital channel labels. |
myScope.WriteString ":DISPlay:LABel ON" ' Turn on labels.
Adds labels to the label list in alphabetical order. Up to 75 labels may be provided, with each label 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. |
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 | Selects the front-panel softkey menu to display or turns the menu off. |
Removes all user messages currently on screen.
Specifies the display persistence setting. You can set zero persistence, infinite persistence, or a variable persistence time in seconds. The corresponding query returns the specified persistence setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MINimum | INFinite | Persistence setting to apply; the manual also allows a variable time value in seconds. |
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.
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. It maps to the Transparent softkey under [Utility] > Options > Preferences.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | ON | Sets the transparent mode state. |
Turns vector display on or off. When enabled, the oscilloscope displays lines connecting sampled data points; on 1 GHz and 1.5 GHz bandwidth models, vectors can be turned off to view just waveform data points.
| Name | Type | Values | Description |
|---|---|---|---|
| vectors | enum | 1 | ON | 0 | OFF | Sets the vectors display state. |
Turns vectors on and off. When vectors are turned on, the oscilloscope displays lines connecting sampled data points; when turned off, only the sampled data is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| connect | enum | 1 | ON | 0 | OFF | Sets the vectors display state. |
Returns the digital channel numbers in screen order from top to bottom, separated by commas. This obsolete command is provided for compatibility with previous oscilloscopes and is only available on MSO models.
Turns the DVM Auto Range capability on or off when the selected DVM source channel is not used in oscilloscope triggering. When on, the DVM channel's vertical scale, vertical position, and trigger level are automatically adjusted.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Enables or disables Auto Range. |
Returns the displayed 3-digit DVM value based on the current mode.
Turns the digital voltmeter (DVM) analysis feature on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Sets whether the DVM analysis feature 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 analog channel used for digital voltmeter (DVM) measurements. The selected channel does not have to be displaying a waveform for DVM measurements to be made.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | CHANnel3 | CHANnel4 | Selects the DVM input source channel. |
:DVM:SOURce CHANnel1 :DVM:SOURce CHANnel2 :DVM:SOURce CHANnel3 :DVM:SOURce CHANnel4
Sets or queries the low-pass filter setting for the external trigger input. The command is provided for product compatibility; use :TRIGger:HFReject to limit bandwidth on the external trigger input.
| Name | Type | Values | Description |
|---|---|---|---|
| bwlimit | enum | 0 | OFF | Low-pass filter setting; only 0 or OFF is accepted. |
Specifies the probe attenuation factor for the external trigger. It does not change the actual input sensitivity of the oscilloscope, but changes 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 external trigger full-scale range. The 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 the probe attenuation changes.
| Name | Type | Values | Description |
|---|---|---|---|
| range | real | V | Vertical full-scale range value in NR3 format. |
| suffixopt | enum | V | mV | Units suffix for the range value. |
Sets the measurement units for the probe connected to the external trigger input. Select VOLT for a voltage probe and AMPere for a current probe; measurement results, channel sensitivity, and trigger level reflect the selected units.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | VOLT | AMPere | Measurement units for the external trigger probe. |
:EXTernal:UNITs <units> :EXTernal:UNITs?
Sets or queries the external probe sense mode compatibility command. The setting cannot actually be changed; if the requested mode matches the oscilloscope setting, the command is accepted, otherwise a setting conflict error is generated.
| Name | Type | Values | Description |
|---|---|---|---|
| pmode value | enum | AUTo | MANual | Probe sense mode value. |
Returns the frequency response analysis data. The data is returned as comma-separated columns for each sweep step: 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.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Sets the FRA feature state. |
Selects the frequency mode for frequency response analysis, either swept frequency response analysis or single-frequency analysis. The query returns the current frequency mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | SWEep | SINGle | Sets the frequency mode. |
Sets the single frequency value for frequency response analysis. The frequency is selected from a fixed list of allowed values and may include an optional unit suffix.
| 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 frequency response analysis. The start frequency can be chosen from decade values, with a minimum of 20 Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 20 - 10000000 | Frequency sweep start value. |
| suffixopt | enum | Hz | kHz | MHz | Unit suffix appended to the value. |
Sets the frequency sweep stop value for frequency response analysis. The stop value can be specified as one of the listed decade values up to 20 MHz, optionally with a unit suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 100 - 20000000 | Frequency sweep stop value. |
| suffixopt | enum | Hz | kHz | MHz | Optional unit suffix for the stop value. |
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 analysis produces gain and phase data for a Bode frequency response chart, and `:FRANalysis:APPLy` is a valid alias.
Selects the analog input channel used to probe the DUT input voltage for frequency response analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog input channel to use, specified as CHANnel<n> with n from 1 to the number of analog channels. |
Specifies the analog input channel that is probing the output voltage from the DUT in frequency response analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Analog input channel used for output-voltage probing. |
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, it 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. It affects the front-panel GUI and saved analysis data.
| Name | Type | Values | Description |
|---|---|---|---|
| selection | enum | NONE | ALL | GAIN | PHASe | Selects which analysis data to include; if gain or phase is selected, a second optional choice may specify the remaining type. |
Selects the expected output load impedance for the waveform generator. The setting affects the displayed amplitude and offset levels for the expected load.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | ONEMeg | FIFTy | Expected output load impedance. |
:FRANalysis:WGEN:LOAD <impedance> :FRANalysis:WGEN:LOAD?
Sets the waveform generator output sine wave amplitude. When amplitude profile is on, the optional range specifies the initial ramp amplitude at the frequency setting.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Amplitude in volts in NR3 format. |
| rangeopt | enum | F20HZ | F100HZ | F1KHZ | F10KHZ | F100KHZ | F1MHZ | F10MHZ | F20MHZ | Initial ramp amplitude frequency setting used when amplitude profile is on. |
Enables or disables the ability to specify amplitude ramping within different decades. The query returns the voltage profile setting as 0 or 1.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns the voltage profile on or off. |
Sets the number of waveforms to be averaged together for the selected math function. 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 source selected for the clock signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | DIGital<d> | Clock signal source to select. |
Specifies the clock signal edge for the Chart Logic Bus State operation.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | Clock 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 | Function number in NR1 format. |
| value | real | - | Value per bus code in NR3 format. |
Specifies the value associated with Chart Logic Bus data equal to zero. The query returns that value.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Math 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 display of math function m on or off. When the display is turned on, the function operates as specified by the other :FUNCtion<m> commands and automatic vertical scaling occurs.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Selects whether the function display is enabled or disabled. |
Sets or queries the FFT bin size for function channel m. The query returns the Bin Size setting for the FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - 4 | Function channel index in NR1 format. |
Sets the FFT center frequency for the selected math function. The query returns the current center frequency in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Math function number in NR1 format. |
| frequency | real | -25 GHz - 25 GHz | Current center frequency in NR3 format. |
Specifies the maximum number of points the FFT detector should decimate to, i.e. the number of buckets used before the selected detection-type reduction is applied. The minimum is 640 points; the maximum depends on whether precision analysis is off or on.
| 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. When detectors are used, the FFT output is decimated and analysis is performed on the reduced data set.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | OFF | SAMPle | PPOSitive | PNEGative | NORMal | AVERage | FFT detector type. |
Sets the start frequency in the FFT math function's displayed range. The query returns the current start frequency in Hertz.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Math function index in NR1 format. |
| frequency | real | Hz | Start frequency in NR3 format. |
Sets the stop frequency for the FFT math function's displayed range. The same range can also be set with :FUNCtion<m>[:FFT]:CENTer and :FUNCtion<m>[:FFT]:SPAN.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Math function number in NR1 format. |
| frequency | real | Hz | Stop frequency in NR3 format. |
Specifies whether FFT is performed on the Main time base window or the ZOOM window when zoom is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| gating | enum | NONE | ZOOM | Selects the gate setting for FFT processing. |
Sets the reference point used to calculate the FFT Phase function, choosing either the trigger point or the beginning of the displayed waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| ref_point | enum | TRIGger | DISPlay | Selects the phase reference point. |
Queries the Resolution Bandwidth setting for the FFT.
Selects which FFT readout type is used for the specified FFT function. The query returns the current readout selection.
| Name | Type | Values | Description |
|---|---|---|---|
| readout_type | enum | SRATe | BSIZe | RBWidth | FFT readout type to select. |
Sets the FFT display frequency span (left graticule to right graticule) 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 function m. The allowed units depend on whether the FFT operation is magnitude or phase.
| 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/VRMS apply to FFT magnitude, and DEGRees/RADians apply to FFT phase. |
Selects the FFT windowing transform used by the specified math function. The HANNing window is the default; the query returns the currently selected window.
| Name | Type | Values | Description |
|---|---|---|---|
| window | enum | RECTangular | HANNing | FLATtop | BHARris | BARTlett | FFT window type to use. |
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, centered symmetrically about the center frequency.
| Name | Type | Values | Description |
|---|---|---|---|
| freq_width | real | - | Frequency width of the band-pass filter in NR3 format. |
:FUNCtion<m>:FREQuency:BANDpass:WIDTh <freq_width> :FUNCtion<m>:FREQuency:BANDpass:WIDTh?
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 |
|---|---|---|---|
| m | integer | 1 - # math functions | Math function index in NR1 format. |
| 3dB_freq | real | - | -3 dB 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 |
|---|---|---|---|
| setting | 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 is used to level a ramped waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| input_offset | real | - | DC offset correction in NR3 format. |
Specifies the 'A' value in the Ax + B operation for math function <m>. The query returns the gain value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | 'A' in Ax + B, value in NR3 format. |
Specifies the B value in the Ax + B operation for function <m>. The query returns the current offset value.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - # math functions | Function index in NR1 format. |
| value | real | - | Offset value B in Ax + B, in NR3 format. |
Sets the voltage or vertical value represented at center screen for the selected function. The legal range is generally +/-10 times the current scale of the selected function, but it varies by function; out-of-range values are coerced to the nearest legal value.
| 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>. Changing the operator while the math function is on causes automatic vertical scaling of the new waveform.
| 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 | CLOCk | Desired math operator, transform, filter, or visualization. |
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 function number in NR1 format. |
| range | real | - | Full-scale vertical axis value in NR3 format. |
Sets the reference level for the selected math function, i.e. the voltage or vertical value represented at center screen. The query returns the current reference level value for the selected function.
| 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 suffix that selects volts or dB units. |
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. |
Sets the time mode for the Chart Serial Signal math function. MAIN plots signal data per acquisition on the normal horizontal time scale; ROLL plots data at the right side of the display and scrolls it across the display over time.
| Name | Type | Values | Description |
|---|---|---|---|
| m | integer | 1 - (# math functions) | Math function index in NR1 format. |
| value | enum | MAIN | ROLL | Selects the time mode. |
Sets the full-scale time range for the Chart Serial Signal math function when ROLL serial chart time mode is selected. The query returns the current time range setting.
| 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. When acquisitions are stopped, the time offset can be adjusted to scroll and zoom the plotted signal values.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Time offset value in NR3 format. |
Sets the number of smoothing points used when :FUNCtion<m>:OPERation is SMOoth. The value 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 | Number of smoothing points to use. |
Selects the first source for function operations, including operator math functions or the single source for transform, filter, or visualization functions. For TRENd operations, the setter reports a settings conflict error and the query returns the source of the measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | FUNCtion<c> | MATH<c> | WMEMory<r> | BUS<b> | Source selection for the first function source. |
Specifies the second source for math operator functions that have two sources. It is not used for transform, filter, or visualization functions except for measurement trend visualization when the measurement requires two sources.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | WMEMory<r> | NONE | Second source for the math function. |
Selects the installed measurement whose trend is shown in the math waveform for the specified trend function slot. The query returns the selected 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. You can specify the printer by integer index in the printer list or by printer name.
| Name | Type | Values | Description |
|---|---|---|---|
| active_printer | numeric | - | Printer to make active, specified as either an index in the printer list or a printer name. |
Controls whether scale factors are output on the hardcopy dump.
| Name | Type | Values | Description |
|---|---|---|---|
| factors | enum | OFF | 0 | ON | 1 | Selects whether hardcopy scale factors are output. |
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 | Whether a formfeed is output between the screen image and factors of a hardcopy dump. |
Controls whether the graticule colors are inverted. The query returns a flag indicating whether graticule colors are inverted or not.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted. |
Sets the hardcopy layout mode. The query returns the selected hardcopy layout mode.
| Name | Type | Values | Description |
|---|---|---|---|
| layout | enum | LANDscape | PORTrait | Hardcopy layout mode. |
Sets the address for a network printer slot. The address is the server/computer name and printer share name in \\server\share format; use :HARDcopy:NETWork:APPLy to apply it.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | Quoted ASCII string address for the network printer slot. |
Applies the network printer settings and makes the printer connection.
Sets the Windows network domain name for the hardcopy network printer slots. 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 to both network printer slots.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | Quoted ASCII password string. |
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 use. |
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 may be empty.
Starts a print job.
Sets the hardcopy destination. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:FILename instead.
| Name | Type | Values | Description |
|---|---|---|---|
| destination | enum | CENTronics | FLOPpy | Selects the hardcopy destination. |
Sets the output filename for print formats whose output is a file. This obsolete command is provided for compatibility with previous oscilloscopes; :SAVE:FILename and :RECall:FILename are the recommended replacements.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string specifying the filename. |
:HARDcopy:FILename <string> :HARDcopy:FILename?
Controls whether grayscaling is performed in the hardcopy dump. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:PALette instead.
| Name | Type | Values | Description |
|---|---|---|---|
| gray | enum | OFF | 0 | ON | 1 | Enables or disables grayscaling in the hardcopy dump. |
Controls whether the graticule colors are inverted or not. This is an obsolete command 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 can be identified, it is selected and cannot be changed. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:APRinter instead.
| Name | Type | Values | Description |
|---|---|---|---|
| driver | enum | AP2Xxx | AP21xx | AP2560 | AP25 | DJ350 | DJ35 | DJ6xx | DJ630 | DJ63 | DJ6Special | DJ6Photo | DJ8Special | DJ8xx | DJ9Vip | OJPRokx50 | DJ9xx | GVIP | DJ55xx | PS470 | PS47 | PS100 | PS10 | CLASer | MLASer | LJFastraster | POSTscript | Printer driver to use for the selected printer. |
Reads and returns screen image data. The query can optionally select the output format as PNG, BMP, or BMP8bit; otherwise the currently selected format is used.
| Name | Type | Values | Description |
|---|---|---|---|
| formatopt | enum | PNG | BMP | BMP8bit | Selects the screen image data format to return. |
Specifies the screen image data format. The setting persists through power cycling and resets to PNG after *RST.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | PNG | BMP | BMP8bit | Screen image data format to use. |
Sets the orientation of the histogram when :HISTogram:MODE is WAVeform. HORizontal displays the histogram at the bottom of the graticule, and VERTical displays it at the left.
| Name | Type | Values | Description |
|---|---|---|---|
| axis | enum | VERTical | HORizontal | Specifies the histogram orientation. |
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 | Installed measurement slot 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 mode. |
Zeros the histogram counters.
Specifies the number of divisions the histogram bar graph uses. For horizontal histograms, valid values are 1.0 to 4.0; for vertical histograms, valid values are 1.0 to 5.0, in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| size | real | 1.0 - 5.0 | Number of divisions used for the histogram bar graph. |
Selects whether the histogram is waveform-based (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 bottom boundary of the histogram limits window when :HISTogram:MODE is WAVeform. The value uses NR3 format and the same units as the input waveform's vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | - | Bottom value for the histogram limits window boundary. |
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 or queries 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 | Waveform source to use for the histogram. |
Sets the histogram limits window's top boundary when :HISTogram:MODE is WAVeform. The value uses NR3 format and the same units as the input waveform's vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| limit | real | - | Top value of the histogram limits window. |
Auto-configures and turns on the jitter measurement histogram for the selected measurement.
Selects the measurement slot to analyze for jitter functions. The query returns the currently selected measurement location.
| Name | Type | Values | Description |
|---|---|---|---|
| MEAS<n> | integer | 1 - 10 | Installed measurement slot number to analyze. |
Auto-configures and turns on the jitter spectrum for the selected measurement.
Sets the center frequency for the jitter measurement spectrum. After :JITTer:SPECtrum:APPLy, this command is an alias for :FUNCtion4[:FFT]:CENTer.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | Hz | X position (center), in NR3 format. |
Sets the frequency span of the jitter measurement spectrum display. After :JITTer:SPECtrum:APPLy, this command is an alias for :FUNCtion4[:FFT]:SPAN.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | Hz | X scaling (span), in NR3 format. |
:JITTer:SPECtrum:HORizontal:RANGe <value> :JITTer:SPECtrum:HORizontal:RANGe?
Sets the vertical value represented at center screen for the jitter measurement spectrum. After :JITTer:SPECtrum:APPLy, this command is an alias for :FUNCtion4:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Y offset, in NR3 format. |
Defines the full-scale vertical range for the jitter measurement spectrum. After :JITTer:SPECtrum:APPLy, it is an alias for :FUNCtion4:RANGe.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Y scaling, in NR3 format. |
Sets the vertical units for the jitter spectrum. After :JITTer:SPECtrum:APPLy, it acts as an alias for :FUNCtion4[:FFT]:VTYPe.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | DECibel | VRMS | Vertical units for the jitter spectrum. |
Selects the windowing transform used for the jitter spectrum FFT. After :JITTer:SPECtrum:APPLy, this command is an alias for :FUNCtion4[:FFT]:WINDow.
| Name | Type | Values | Description |
|---|---|---|---|
| window | enum | RECTangular | HANNing | FLATtop | BHARris | BARTlett | Selects the windowing transform for the jitter spectrum FFT. |
Enables or disables the jitter analysis feature. When enabled, the Jitter front panel key is lit and precision measurements with 1M analysis record length are forced on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns jitter analysis off or on. |
Auto-configures and turns on the jitter measurement trend for the selected measurement.
Auto-configures and turns on smoothing for the jitter measurement trend.
Sets the number of jitter trend smoothing points to use when jitter trend smoothing is turned on. The query returns the specified number of smoothing points.
| Name | Type | Values | Description |
|---|---|---|---|
| points | integer | 3 - half of the measurement record or precision analysis record | Odd integer number of smoothing points in NR1 format. |
Sets the vertical value represented at center screen for the jitter measurement trend. After :JITTer:TRENd:APPLy, it is an alias for :FUNCtion2:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Y offset, in NR3 format. |
Defines the full-scale vertical range for the jitter measurement trend. After :JITTer:TRENd:APPLy, it is an alias for :FUNCtion2:RANGe.
| Name | Type | Values | Description |
|---|---|---|---|
| value | string | - | Y scaling, 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 from 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 Lister time value for each row is relative to the trigger or to the previous Lister row. The query returns the current Lister time reference setting.
| Name | Type | Values | Description |
|---|---|---|---|
| time_ref | enum | TRIGger | PREVious | Selects the time reference for Lister rows. |
For the measurement selected by :LTESt:MEASurement, sets the upper and lower limits to the last measurement result plus or minus a percent margin. The margin is configured with :LTESt:COPY:MARGin.
Sets the upper and lower limits for all measurements whose limits are being tested, using the last measurement result plus or minus a percent margin. It performs the :LTESt:COPY operation on all applicable measurements.
Sets the percent margin used when setting upper and lower limits by copying from measurement results 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. The query returns whether the feature is on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Specifies whether limit test is disabled or enabled. |
Sets the fail condition for the active measurement selected by :LTESt:MEASurement. When a limit test failure is detected, the selected fail action conditions are executed and may generate an SRQ.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | INSide | OUTSide | Fail condition for the measurement. |
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 real-number 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 | Installed measurement number to select. |
Returns the measurement results for the selected 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 to query. |
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 | Selects whether stop on failure is disabled or enabled. |
Enables or disables the limit test function for the active measurement selected by :LTESt:MEASurement. When any measurement has limit test enabled, the overall Limit Test feature is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the TEST control state. |
Sets the upper test limit for the active measurement currently 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 front-panel cursors are off, the marker position values are not defined.
Sets the cursor mode. The query returns the current cursor mode.
| 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 | Controls whether the X1 cursor is displayed. |
Sets the X1 cursor position to the specified value and forces :MARKer:MODE to MANual if it is not currently WAVeform. The X cursor units are set by :MARKer:XUNits.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | X1 cursor position in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Hz | kHz | MHz | Optional unit suffix for the 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 sets both marker pairs to the same source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | HISTogram | CGRade | 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 | Sets whether the X2 cursor is displayed. |
Sets the X2 cursor position to the specified value. The command also 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 unit suffix for the position value. |
Sets the source for the cursors. The selected channel or function must be enabled for cursors to be displayed; otherwise an error is issued.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | HISTogram | CGRade | Source used for the cursors. |
Returns the value difference between the current X1 and X2 cursor positions. Xdelta is calculated as (Value at X2 cursor) - (Value at X1 cursor).
Sets the X cursors units. The choice 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 location as 0 degrees and the current X2 location as 360 degrees when :MARKer:XUNits is set to DEGRees, or as 0 percent and 100 percent when :MARKer:XUNits is set to PERCent. Inputs to and outputs from :MARKer:X1Position, :MARKer:X2Position, and :MARKer:XDELta are then relative to those set locations.
Specifies whether the Y1 cursor is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Controls whether the Y1 cursor is displayed. |
Sets the Y1 cursor position from an NR3-formatted value with an optional unit suffix. If :MARKer:MODE is not WAVeform, the command forces :MARKer:MODE to MANual and updates the Y1 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 | Controls whether the Y2 cursor is displayed. |
Sets the Y2 cursor position in NR3 format and may optionally include a unit suffix of mV, V, or dB. If :MARKer:MODE is not currently WAVeform, the command sets :MARKer:MODE to MANual; 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 position value. |
Returns the difference between the current Y1 and Y2 cursor positions. Ydelta is defined as the value at Y2 cursor minus the value at Y1 cursor.
Sets the Y cursor units. BASE uses the units associated with the cursor source, and PERCent uses ratio measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | BASE | PERCent | Selects the Y cursor units. |
When PERCent is selected for :MARKer:YUNits, this command sets the current Y1 location as 0 percent and the current Y2 location as 100 percent. After the 0 and 100 percent locations are set, inputs to and outputs from :MARKer:Y1Position, :MARKer:Y2Position, and :MARKer:YDELta are relative to those set locations.
Installs a Snapshot All measurement on the screen.
Installs an area measurement on screen. The optional <interval> selects either an integral number of cycles or the full screen; if omitted, DISPlay is implied. The query measures and returns the area value.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval to use for the area measurement. |
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Signal source for the area measurement. |
Installs a screen measurement and starts the bit rate measurement. If an optional source is specified, the currently specified source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Measurement source to use; may be a digital channel, analog channel, math function, or waveform memory reference. |
Installs a burst width measurement on screen. If the optional source is not 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. |
Clears all selected measurements and markers from the screen.
Installs a screen counter measurement and starts counting trigger level crossings for the specified source. If a source is supplied, it changes the current source; only one counter measurement may be displayed at a time.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | DIGital<d> | CHANnel<n> | EXTernal | Measurement source to count; any channel except Math or Reference Waveforms may be selected. |
Installs a -Width to -Width (cycle-to-cycle negative width) jitter measurement on screen. The measurement is available only when the optional jitter analysis feature is licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Source channel for the measurement. |
Installs a +Width to +Width (cycle-to-cycle positive width) jitter measurement on screen. The measurement is available only when the optional jitter analysis feature is licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Measurement source channel. |
Sets up the measurement definition for delay or threshold measurements by specifying the delay edge specification or threshold values. Changing these values may affect results of other measurement commands.
| Name | Type | Values | Description |
|---|---|---|---|
| meas_spec | enum | DELay | THResholds | Selects whether to define delay measurement parameters or threshold measurement values. |
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Specifies the source waveform or function associated with the measurement definition. |
Places the instrument in continuous measurement mode and starts a delay measurement between two sources. The edge selection mode defaults to AUTO for the command and MANual for the query if omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| edge_select_modeopt | enum | MANual | AUTO | Selects whether edges are chosen automatically or by the delay define settings. |
| source1opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d> | Specifies the first measurement source. |
| source2opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d> | Specifies the second measurement source. |
Defines the slope directions, edge numbers, and edge position thresholds used by 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 position threshold 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 position threshold for source 2. |
Installs or queries a dual charge measurement on screen. The optional interval selects cycles or full screen; if omitted, DISPlay is implied. Optional source parameters can modify the currently specified sources.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval to use. |
| source1opt | channel_list | - | First measurement source channel, with N2820A probe connected. |
| source2opt | channel_list | - | Second measurement source channel, with N2820A probe connected. |
Installs a screen measurement and starts a vertical amplitude measurement. If optional source parameters are specified, the currently specified sources are modified.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | discrete | - | First measurement source, specified as CHANnel<n> with an N2820A probe connected. |
| source2opt | discrete | - | Second measurement source, specified as CHANnel<n> with an N2820A probe connected. |
Installs a screen measurement and starts an average value measurement using the specified interval and optional source(s). The query returns the calculated average value measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval: an integral number of cycles or the full screen. |
| source1opt | channel_list | - | First source channel, with N2820A probe connected. |
| source2opt | channel_list | - | Second source channel, with N2820A probe connected. |
Installs a screen measurement and starts a waveform base value measurement. If optional source parameters are specified, the currently specified sources 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 for the N2820A high sensitivity current probe. 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, expressed as CHANnel<n> with N2820A probe connected. |
| source2opt | channel_list | - | Second source channel for the measurement, expressed as CHANnel<n> with N2820A probe connected. |
Installs a screen measurement and starts an RMS value measurement. Optional interval, type, and source parameters can be used to specify the measurement setup; if omitted, DISPlay and DC are implied for the interval and type.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval: an integral number of cycles or the full screen. |
| typeopt | enum | AC | DC | Selects AC or DC RMS measurement. |
| source1opt | channel_list | - | First source channel for the dual measurement, using CHANnel<n> with an N2820A probe connected. |
| source2opt | channel_list | - | Second source channel for the dual measurement, using CHANnel<n> with an N2820A probe connected. |
Installs a screen measurement and starts a positive duty cycle measurement on the current :MEASure:SOURce. If an optional source is specified, it becomes the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | DIGital<d> - WMEMory<r> | Selects the source signal to measure. |
Installs a screen measurement and starts a fall-time measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<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 used for the measurement. |
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | FFT waveform source used for the measurement. |
Installs an FFT analysis Channel Power measurement on screen. The center frequency is taken from the FFT function and the FFT span defines the frequency range; when tracked with cursors, the cursors are placed at the span edges.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | FFT waveform source for the measurement. |
Installs an FFT analysis Occupied Bandwidth measurement on screen. The measurement bandwidth is defined as the frequency range containing the specified percentage of total spectral power.
| Name | Type | Values | Description |
|---|---|---|---|
| percentage | real | - | Percent of spectral power occupied bandwidth is measured for. |
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | FFT waveform source to use for the measurement. |
Installs an FFT analysis Total Harmonic Distortion measurement on screen. You can enter the fundamental frequency manually or have it tracked automatically; the source must be an FFT waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| tracking | enum | AUTO | MANual | Selects automatic or manual tracking of the fundamental frequency. |
| fundamental_freqopt | real | - | Fundamental frequency in NR3 format; required when tracking is MANual. |
| sourceopt | enum | FUNCtion<m> | MATH<m> | FFT | Specifies the FFT waveform source. |
Installs a screen frequency measurement and starts measuring frequency. If an optional source is specified, it modifies the current source. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | - | - | Measurement source to use. |
Queries 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 histogram bin.
Returns the delta between the maximum and minimum values.
Returns the standard deviation of the histogram values.
Installs an N-cycle period-period jitter measurement on screen using the specified source, edge direction, and number of periods. This measurement is available only when the optional jitter analysis feature is licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source waveform. |
| direction | enum | RISing | FALLing | Edge direction used for the measurement. |
| num_periods | integer | 1 - 10000 | Number of periods in the jitter group. |
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 | discrete | - | Measurement source to use; may be a digital channel, analog channel, function, math trace, or waveform memory reference. |
Installs an on-screen falling edge count measurement. 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> | Measurement source to use. |
Installs an N-period jitter measurement on screen. The query measures and returns the N-Period jitter value.
| Name | Type | Values | Description |
|---|---|---|---|
| source | - | - | Signal source for the measurement. |
| slope | enum | RISing | FALLing | Edge slope used for the measurement. |
| num_periods | integer | 1 - 10000 | Number of consecutive periods used for the measurement. |
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. |
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 | discrete | - | Measurement source to use. |
Installs a screen measurement and starts an overshoot measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source channel, math function, or waveform memory. |
Installs an on-screen rising edge count measurement. If no source is specified, the current source is measured; 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 period measurement. If an optional source is specified, the current source is modified. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Measurement source to use. |
Starts a continuous phase measurement between one or two specified sources. The query measures and returns the phase angle between the specified sources in degrees.
| 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 rising pulse count measurement on screen. If the optional source is not specified, the current source is measured; the command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d> | Measurement source to use. |
Installs a screen measurement and starts a preshoot measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the waveform source for the preshoot measurement. |
Installs a screen measurement and starts the positive pulse width measurement. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Measurement source: a digital channel, analog channel, function, math function, or memory waveform. |
Returns the results of the continuously displayed measurements. The response is a comma-separated list of measurement results, and may be empty if no quick measurements are installed.
:MEASure:RESults?
Installs a screen rise-time measurement and starts measuring rise time. If an optional source is specified, the current source is modified.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the measurement source. |
Installs the real-time eye height measurement on screen when real-time eye analysis is enabled. The measurement uses the color grade database, and :MEASure:SOURce is automatically set to CGRade.
Installs the real-time eye width measurement on screen when real-time eye analysis is enabled. The measurement uses the color grade database and automatically sets :MEASure:SOURce to CGRade.
Installs a screen measurement and starts standard deviation measurement. If an optional source is specified, the current source is modified. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the waveform source to measure. |
Enables markers for tracking measurements on the display.
| 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 using an optional source and slope. If no source is specified, the current :MEASure:SOURce setting is used; if no slope is specified, a rising edge is measured.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | string | - | Measurement source waveform, such as a channel, function, math trace, or waveform memory. |
| slopeopt | enum | RISing | FALLing | EITHer | Selects whether to measure a rising edge, falling edge, or either edge. |
Sets the default measurement source selections used by MEASure subsystem commands when sources are not explicitly specified. If a source is specified for any measurement, the current source is changed to that value.
| Name | Type | Values | Description |
|---|---|---|---|
| source1 | enum | 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. |
:MEASure:SOURce CHANnel1
Sets the statistics mode used by the :MEASure:RESults? query. ON means all statistics are enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | ON | 1 | CURRent | MINimum | MAXimum | MEAN | STDDev | COUNt | Selects which statistics information is returned by :MEASure:RESults?. |
Disables or enables the display of the measurement statistics. The query returns the current state of the measurement statistics display.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Controls whether measurement statistics are displayed. |
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. |
| count | integer | 2 - 2000 | 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, i.e. standard deviation divided by 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 that returns the time of the specified edge transition relative to the trigger edge. If no source is specified, the current :MEASure:SOURce setting is used.
| 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; an occurrence of 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 for the measurement. |
Installs a Data TIE (Time Interval Error) jitter measurement on screen using the specified source and data type. This measurement is available only when the optional jitter analysis feature is licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Measurement source, selected from a channel, function, math trace, or reference waveform. |
| type | enum | SECond | UNITinterval | Data TIE measurement type. |
Installs a clock TIE jitter measurement on screen. The measurement compares edges in a clock signal with the edges in an ideal clock signal determined by the clock recovery feature.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Source waveform for the measurement. |
| timebase | enum | SECond | UNITinterval | Measurement time base or units selector. |
| direction | enum | RISing | FALLing | BOTH | Edge direction used for the measurement. |
Queries the time interval between the trigger event and the specified value crossing of the displayed signal. If the optional source parameter is given, the current source is modified; the query is not available for FFT sources.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The vertical value that the waveform must cross. |
| slopeopt | enum | + | - | Direction of the waveform crossing; '+' indicates rising and '-' indicates falling. |
| occurrence | integer | - | The transition number to be reported. |
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the signal source 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 amplitude measurement. |
Installs a screen measurement and starts an average value measurement. The optional interval defaults to DISPlay if not specified, and an optional source can modify the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval to use for the average value 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 base value measurement. If an optional source is specified, the current source is modified. The command is not available if the source is FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the waveform source to measure. |
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 source waveform for the measurement. |
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 | channel_list | - | Selected waveform source to measure. |
Installs a screen measurement and starts a vertical peak-to-peak measurement. If an optional source is specified, the current source is modified. The query measures the selected source and returns its vertical peak-to-peak value, calculated as Vmax - Vmin.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | - | - | Source to measure. |
Installs or queries a ratio measurement on screen using the AC RMS values of two sources, expressed in dB. If <interval> is omitted, DISPlay is implied.
| 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 source used for the ratio measurement. |
| source2opt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Second source used for the ratio measurement. |
Installs a screen measurement and starts an RMS value measurement. The optional interval selects cycle count or display, the optional type selects AC or DC RMS, and an optional source can modify the current source.
| Name | Type | Values | Description |
|---|---|---|---|
| intervalopt | enum | CYCLe | DISPlay | Measurement interval: integral number of cycles or the full screen. |
| typeopt | enum | AC | DC | RMS measurement type: AC or DC. |
| sourceopt | discrete | - | Measurement source. |
Installs a screen measurement and starts a waveform top value measurement. The source can be a channel, function, or math waveform; the query returns the vertical value at the top of the waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Selects the 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 | Measurement window selection. |
Installs a screen measurement and starts an X-at-Max-Y measurement on the selected window. It is an alias for :MEASure:TMAX; 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 screen measurement and starts an X-at-Min-Y measurement on the selected window. If an optional source is specified, it modifies the current source. This command is an alias for :MEASure:TMIN.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Selects the measurement source. |
Installs or queries a screen measurement of the vertical value at a specified horizontal location 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; when the source is an FFT waveform, this is a frequency value instead. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source to use. |
Installs a power phase angle measurement on screen using one or two channel sources. The first source is the probing voltage channel and the second source is the probing current channel; they may also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | channel_list | 1 - # analog channels | Channel probing voltage source. |
| source2opt | channel_list | 1 - # analog channels | Channel probing current source. |
Installs an apparent power measurement on screen using one or two channel sources. The first source is the voltage channel and the second source is the current channel; these sources may 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 a power loss per cycle measurement on screen. The source can be specified by :MEASure:SOURce; the measurement operates in zoom mode with the counter measurement installed on the voltage of the switching signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | discrete | FUNCtion<m> | MATH<m> | Primary source for the power-loss-per-cycle measurement. |
| source2opt | discrete | CHANnel<n> | Secondary source channel. |
Installs a crest factor measurement on screen. The optional <source> selects the channel, function, or math source used for the measurement; it can also be set with :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Channel, function, or math source for the crest factor measurement. |
Installs an efficiency measurement on screen. Before sending this command or query, 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 is typically a math multiply waveform or other waveform representing power, and can also be set by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Measurement source waveform. |
Installs a power factor measurement on screen. The source1 parameter is the channel probing voltage and source2 is the channel probing current; both may also be specified by :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 required source channels must be specified and automated signals setup must be performed.
Installs an off-time measurement on screen. The measurement is the time difference between the input AC voltage falling to 10% of its maximum amplitude and the output DC voltage falling 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 screen using one or two channel sources. The first source is the AC voltage input and the second source is the DC voltage input; sources may 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 input voltage/current and output voltage/current source channels must be specified and automated signals setup must be performed.
Installs a peak current measurement on screen. The source channel probing the current can also be specified by :MEASure:SOURce; the query returns the measured peak current.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Channel, function, math, or reference waveform source used for the measurement. |
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 | discrete | 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 parameters specify the channel probing voltage and current, and can also be set via :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source1opt | discrete | - | Channel probing voltage source. |
| source2opt | discrete | - | Channel probing current source. |
Installs a real power measurement on screen using the specified source. The source is typically a math multiply waveform or other waveform representing power, and can also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | Measurement source to use for the real power calculation. |
Installs an output ripple measurement on screen. The <source> parameter selects the channel or waveform source probing the output voltage and can also be set by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | Source used for the ripple measurement. |
Installs a transient response time measurement on screen. The source is the channel probing the output voltage and can also be specified by :MEASure:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | channel_list | - | Channel, function, math, or waveform memory source used for the measurement. |
Installs a power Vce(sat) measurement on screen, using an optional source waveform. The corresponding query returns the measured Vce(sat) value.
| Name | Type | Values | Description |
|---|---|---|---|
| sourceopt | discrete | - | Measurement source waveform. |
Sets the lower measurement threshold value. The command is obsolete and provided for backward compatibility; use :MEASure:DEFine THResholds instead.
| Name | Type | Values | Description |
|---|---|---|---|
| voltage | real | V | The lower threshold value. |
Clears all selected measurements and markers from the screen. This command is obsolete and provided for backward compatibility; use :MEASure:CLEar instead.
Obsolete query command that returns the time difference between the Tstart marker (X1 cursor) and the Tstop marker (X2 cursor). It 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 waveform source to measure. |
Installs a screen measurement and starts an X-at-Min-Y measurement on the selected waveform. If an optional source is specified, it modifies the current source. 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. |
:MEASure:TMIN [<source>]
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 | Unit suffix for the time value. |
Moves the stop marker (X2 cursor) to the specified time with respect to the trigger time. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:X2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | s | Time at the stop marker in seconds. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Measures the time interval from the trigger event to a specified voltage crossing on the displayed signal. The command is obsolete and provided for backward compatibility; use :MEASure:TVALue instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | The voltage level that the waveform must cross. |
| slopeopt | integer | - | Direction of the waveform crossing; rising is indicated by + and falling by -. |
| occurrence | integer | - | The transition number to report; 1 returns the first crossing, 2 the second, and so on. |
| sourceopt | enum | DIGital<d> | CHANnel<n> | FUNCtion | MATH | Selects the source signal to be measured. |
Sets the upper measurement threshold value. The value is used with :MEASure:LOWer as an absolute value for ABSolute thresholds or as a percentage for PERCent thresholds defined by :MEASure:DEFine THResholds.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Upper measurement threshold value. |
Obsolete query that returns the voltage difference between vertical marker 1 (Y1 cursor) and vertical marker 2 (Y2 cursor). The returned delta is the current value, equal to marker 2 minus marker 1.
Moves the vertical marker (Y1 cursor) to the specified value corresponding to the selected source. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:Y1Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| vstart_argument | real | V | Value for vertical marker 1. |
Moves the vertical marker 2 (Y2 cursor) to the specified value for the selected source. This obsolete command is provided for compatibility; use :MARKer:Y2Position instead.
| Name | Type | Values | Description |
|---|---|---|---|
| vstop_argument | real | - | Value for the Y2 cursor. |
Returns the vertical value at a specified horizontal location on the specified source. The horizontal argument is time in seconds from trigger, or frequency when the source is an FFT waveform; if the optional source is given, the measurement source is modified.
| 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 to use. |
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 current selected channel using the tolerance parameters defined by :MTESt:AMASk:XDELta, :MTESt:AMASk:YDELta, and :MTESt:AMASk:UNITs. The mask only encompasses the portion of the waveform visible on the display.
Selects the source used to interpret the :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta parameters when :MTESt:AMASk:UNITs is set to CURRent. It is the same as :MTESt:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the source channel. |
Alters the way the mask test subsystem interprets tolerance parameters for automasking. The setting can be based on the current channel units or on screen divisions.
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | CURRent | DIVisions | Selects whether automasking uses the channel units or graticule divisions. |
Sets the tolerance in the X direction around the waveform for the automasking feature. The absolute tolerance is added and subtracted from horizontal waveform values to determine mask boundaries; 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 parameter is given.
| Name | Type | Values | Description |
|---|---|---|---|
| channel<n>opt | channel_list | 1 - # analog channels | Channel to query. |
Resets the mask statistics.
Returns the elapsed time in the current mask test run.
Returns the total number of waveforms acquired in the current mask test run.
Loads a mask from binary block data. The query returns a mask in IEEE 488.2 binary block data format.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | block | - | Binary block data in IEEE 488.2 # format. |
Clears the currently loaded mask.
Enables or disables the mask test features.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask test features on or off. |
Enables or disables the mask lock feature. When ON, the mask is locked to the source and is redrawn as the source scale or position changes; when OFF, the mask is static.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Selects whether mask lock is enabled or disabled. |
Sets the mask test termination condition. The available conditions are forever, sigma level, time, or a fixed number of waveforms.
| Name | Type | Values | Description |
|---|---|---|---|
| rmode | enum | FORever | SIGMa | TIME | WAVeforms | Termination condition for the mask test. |
Sets measuring only mask failures on or off. When ON, measurements and measurement statistics run only on waveforms that contain a mask violation; passing waveforms do not affect measurements and statistics.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask-failure-only measurement mode on or off. |
Sets printing of mask failures on or off. Turning printing ON automatically sets :MTESt:RMODe:FACTion:SAVE OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables printing of mask failures. |
Sets saving on mask failures on or off. Setting :MTESt:RMODe:FACTion:SAVE ON automatically sets :MTESt:RMODe:FACTion:PRINt OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns mask-failure saving on or off. |
Sets whether mask-test 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 | Enables or disables stopping on a mask failure. |
Sets the test sigma level used when :MTESt:RMODe is set to SIGMa. The level indirectly specifies how many waveforms must be tested to reach the sigma level.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.1 - 9.3 | Sigma level to set, in NR3 format. |
Sets or queries the number of seconds for a mask test to run when :MTESt:RMODe is set to TIME.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | real | 1 - 86400 | Number of seconds for the mask test run time. |
Sets the number of waveform acquisitions that are mask tested when :MTESt:RMODe is set to WAVeforms. The query returns the number of waveforms currently set.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 1 - 2,000,000,000 | Number of waveforms in NR1 format. |
Enables or disables Bind 1 & 0 Levels control, or Bind -1 & 0 Levels for inverted masks. When enabled, adjusting either bound level shifts the mask position without changing its size.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Enables or disables the bind control. |
Defines where X=0 in the base coordinate system used for mask testing. The X1 value specifies the location of the X1 coordinate, which is then treated as X=0 for mask region coordinates.
| Name | Type | Values | Description |
|---|---|---|---|
| x1_value | real | - | X1 value in NR3 format. |
Defines the position of the X2 marker with respect to the X1 marker in the mask test coordinate system. The X delta value is a time value specifying the distance of X2 from X1.
| Name | Type | Values | Description |
|---|---|---|---|
| xdelta_value | real | - | X delta value in NR3 format. |
Defines where Y=0 in the mask-testing coordinate system. 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 is a voltage value specifying the location of the Y2 marker.
| 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.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Specifies the channel to use, in CHANnel<n> form. |
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 oscilloscope 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. |
:MTESt:AVERage <on_off> :MTESt:AVERage?
Sets the number of averages for the waveform. With the AVERage acquisition type, it specifies the number of data values to be averaged for each time bucket before the acquisition is considered complete for that time bucket.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 65536 | Number of averages to set. |
Loads the specified mask file. The command is obsolete and provided for backward compatibility; use :RECall:MASK[:STARt] instead.
| Name | Type | Values | Description |
|---|---|---|---|
| filename | string | - | MS-DOS compatible file name, up to 254 characters long including the path name if used. |
Sets the termination conditions for the mask test. Choices are FORever, TIME,<seconds>, or WAVeforms,<wfm_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. |
| seconds | real | 1 - 86400 | Amount of time in seconds before the mask test terminates. |
| wfm_count | integer | 1 - 1,000,000,000 | Maximum number of waveforms required before the mask test terminates. |
Enables or disables the Stop On Failure run-until criteria for mask 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 obsolete command is provided for backward compatibility to previous oscilloscopes.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Channel to use as the trigger. |
Turns displaying of the specified group of channels on or off. This command is only valid for the MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Display setting for the specified POD channel group. |
Specifies the size of the digital channels on the display for the pod groups. The setting applies to both pods, and the command is only valid for MSO models.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Defines the group of channels affected by the command. |
| value | enum | SMALl | MEDium | LARGe | Sets the 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 type or a user-defined threshold value. |
| suffixopt | enum | V | mV | uV | Optional 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 used to determine control loop margin. The analysis sweeps an input sine wave across frequency while measuring input and output RMS voltages with 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 data from a sweep or single-frequency analysis. |
Returns the gain margin in dB 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 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. If the value cannot be calculated from the last sweep, the query returns +9.9E+37.
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.
Specifies 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 mode or single-frequency mode. |
Sets the single frequency value used for control loop response analysis. The frequency is displayed on a log-scale Bode plot and can be entered as a decade value in addition to 20 Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 20 - 10000000 | Single frequency value to set. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency unit suffix. |
no examples documented
Sets the control loop response analysis frequency sweep start value. The start value may be specified as a decade value or the minimum frequency of 20 Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 20 - 10000000 | Frequency sweep start value. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency unit suffix. |
Sets the frequency sweep stop value for the control loop response analysis. The stop value is displayed on a log-scale Bode plot and can be selected from decade values up to 20 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 100 - 20000000 | Frequency sweep stop value. |
| suffixopt | enum | Hz | kHz | MHz | Units for the frequency value. |
Selects the number of frequency test points per decade in the log scale. The query returns the current points-per-decade setting.
| Name | Type | Values | Description |
|---|---|---|---|
| pts | integer | 10 - 100 | Number of frequency test points per decade. |
Selects the oscilloscope channel that is probing the power supply input. The query returns the current channel selection.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Channel to use as the power supply input probe source. |
Selects the oscilloscope channel that is probing the power supply output. The query returns the channel selection.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Channel number in NR1 format, from 1 to the number of analog channels. |
Specifies whether to include gain, phase, both gain and phase, or neither in the control loop 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 control loop response data to include; optional second item may specify gain or phase when using the two-item form. |
Sets the waveform generator expected output load impedance. The selection affects how the generator displays 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 optional range parameter, you can set an initial ramp amplitude for each frequency range when the amplitude profile is enabled; without it, the command 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 the initial ramp amplitude is set. |
Enables or disables amplitude profiling for setting initial waveform generator ramp amplitudes for each frequency range. The query returns the current voltage profile setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns voltage profile off or on. |
Launches the auto deskew process on the oscilloscope. 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 | Selects the power-conversion type used for efficiency measurements. |
Enables or disables power analysis. The query returns 1 when power analysis is enabled and 0 when it is disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets whether power analysis is enabled or disabled. |
Applies the current harmonics analysis.
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.
Sets 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 for harmonics analysis. |
Returns the power factor for the IEC 61000-3-2 Standard Class C power factor value.
Sets the Real Power source used for the current-per-watt measurement when Class D harmonics analysis is selected. Use USER with the related :POWer:HARMonics:RPOWer:USER command to enter the user-defined value.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | MEASured | USER | Selects whether Real Power is measured by the oscilloscope or defined by the user. |
Specifies the user-defined real power value used in the current-per-watt measurement when Class D is the current harmonics analysis standard and a user-defined real power value is selected. The query returns that user-defined real power value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 1.0 - 600.0 | User-defined real power value in watts. |
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 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 it 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.
Advances the inrush current analysis to the next step. 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, including trending of pulse width, duty cycle, period, and frequency.
Selects either the voltage source or the current source as the source for modulation analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | V | I | Selects the modulation-analysis source. |
Selects the modulation analysis measurement type. The query returns the currently selected modulation type setting.
| Name | Type | Values | Description |
|---|---|---|---|
| modulation | enum | VAVerage | ACRMs | VRATio | PERiod | FREQuency | PWIDith | NWIDth | DUTYcycle | RISetime | FALLtime | Modulation measurement type to select. |
Applies the selected turn on/off analysis test. It uses the test selected by :POWer:ONOFf:TEST.
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 rise 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 |
|---|---|---|---|
| test type | enum | 0 | OFF | 1 | ON | Selects the test type. |
Specifies the input and output thresholds used for Turn On/Turn Off analysis. The command sets thresholds for the selected analysis type, and the query returns the current input and output threshold settings.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | ON | OFF | Selects the turn on/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 waveform generator to sweep a ripple signal over frequency and measure the input-to-output AC RMS ratio.
Returns PSRR power analysis data. 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 return data from sweep or single-frequency analysis. |
Sets the end sweep frequency value for the PSRR measurement. The PSRR measurement is displayed on a log scale, so decade values are available in addition to 20 MHz.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 10 - 20000000 | Sweep end frequency value. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency suffix. |
Sets the start sweep frequency value for PSRR measurements. The frequency is displayed on a log scale, so only decade values are allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 1 - 10000000 | Start sweep frequency value. |
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 only decade values are selectable.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1 - 10000000 | Single frequency value to set. |
| suffixopt | enum | Hz | kHz | MHz | Optional frequency suffix. |
Selects the number of frequency test points per decade in the log 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 | Number of frequency test points per decade. |
Selects the oscilloscope channel that is probing 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 source. |
Selects the oscilloscope channel that probes the power supply output. The query returns the current channel selection.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Oscilloscope channel number in CHANnel<n> form. |
Specifies whether to include gain (PSRR) data in the power supply rejection ratio analysis results. It affects the front-panel graphical user interface and saved analysis data.
| Name | Type | Values | Description |
|---|---|---|---|
| selection | enum | NONE | GAIN | Selects whether gain (PSRR) data is included in the analysis results. |
Sets the waveform generator expected output load impedance. The setting lets the waveform generator display the 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 amplitude profile enabled, an initial ramp amplitude can be set for each frequency range; without <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 the amplitude applies. |
Enables or disables voltage profiling for initial waveform generator ramp amplitudes in each frequency range. The query returns the current voltage profile setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns voltage profiling off or on. |
Applies the currently selected power quality analysis type. The command is used to enable power quality analysis on the AC input line.
Applies the output ripple analysis.
Performs automated oscilloscope setup for 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 autoset up. |
Specifies the number of cycles to include in the current harmonics 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 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. |
Specifies 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 value is entered in NR3 format with an optional time suffix of s, ms, us, or ns.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Duration value in NR3 format. |
| suffixopt | enum | s | ms | us | ns | Optional time 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 | - | Duration value in NR3 format. |
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 suffix. |
Sets 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, 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 | Units for the expected current value. |
Sets the percent of overshoot of the output voltage, used to determine the transient response settling band and 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 only positive values are allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Maximum expected input voltage in NR3 format. |
| suffixopt | enum | V | mV | Unit suffix appended to the value. |
Sets the maximum expected input voltage used for turn-off analysis and vertical scale adjustment. The value is interpreted in NR3 format with an optional V or mV suffix; negative values are allowed for DC, while AC uses only positive peak-to-peak values.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Maximum expected input Voltage in NR3 format. |
| suffixopt | enum | V | mV | Units suffix for the value. |
Sets the maximum expected input voltage used for turn-on analysis and vertical scale probing voltage. For DC input, it defines the maximum DC input voltage amplitude; for AC input, it defines the maximum peak-to-peak input voltage.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Maximum expected input voltage in NR3 format. |
| suffixopt | enum | V | mV | Unit suffix for the voltage value. |
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. |
| suffixopt | enum | V | mV | Optional unit suffix. |
Sets the expected steady-state output DC voltage used for transient response analysis, settling-band calculation, and oscilloscope vertical scaling. The query returns the current expected steady-state voltage setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | V | Expected steady-state output voltage value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix for the voltage value. |
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 voltage source channel setting.
| Name | Type | Values | Description |
|---|---|---|---|
| source | string | - | Voltage source channel, CHANnel<n>. |
Applies the slew rate analysis.
Selects either the voltage source or the current source as the source for slew rate analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | V | I | Selects the source used for the slew rate analysis. |
Applies the switching loss analysis using the conduction calculation method, V reference, and I reference settings.
Specifies the conduction calculation method used for the Power waveform. Available methods are waveform calculation, Rds(on) error correction, or Vce(sat) error correction.
| Name | Type | Values | Description |
|---|---|---|---|
| conduction | enum | WAVeform | RDS | VCE | Conduction calculation method. |
Specifies the current switching level for the start of switching edges. The value is a percentage of the maximum switch current and is used as the threshold to determine switching edges.
| 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 value is entered in NR3 format and may be followed by a unit suffix of OHM or mOHM.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Rds(on) value in NR3 format. |
| suffixopt | enum | OHM | mOHM | Unit suffix for the Rds(on) value. |
Specifies the Vce(sat) value used when the VCE conduction calculation method is selected. The query returns the current Vce(sat) value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Vce(sat) value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix for the value. |
Specifies the voltage switching level used for switching edges as a percentage of the maximum switch voltage. The threshold can be adjusted to ignore noise floors.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | % | Percent in NR1 format. |
Applies the transient analysis using the initial current and new current settings.
Exits (stops) the transient analysis. This command 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 | Unit suffix for the current value. |
Advances the power transient analysis to the next step. This command 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 CSV file. An optional column and waveform generator ID may be specified; for internal locations, the column parameter is ignored.
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | Internal location or quoted ASCII file name identifying the source waveform. |
| columnopt | integer | 1 | CSV file column 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 string naming the DBC file to load. |
| serialbusopt | string | - | Specifies which serial decode waveform the CAN symbolic data will be loaded for. |
Specifies the source for any RECall operations. It sets the file 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 in <file_name>, it must be ".ldf".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string naming the LDF file to load. |
| serialbusopt | string | - | Specifies which serial decode waveform the LIN symbolic data will be loaded for. |
Recalls a mask. A file specification may be an internal location or a quoted file name; if a file extension is provided, it must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | - | - | Internal location or quoted file name to recall. |
Sets the present working directory for recall operations. The query returns the currently set working directory.
| Name | Type | Values | Description |
|---|---|---|---|
| path_name | string | - | Quoted ASCII string specifying the directory path. |
Recalls an oscilloscope setup. A file name, if provided, must use the .scp extension.
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | Internal location or quoted ASCII file name to recall from. |
Recalls a reference waveform. The optional argument is either a quoted ASCII file name or binary block data; if a file extension is provided, 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 of the reference waveform file. |
| dataopt | block | - | Binary block data in IEEE 488.2 # format. |
Starts building the real-time eye using full-length acquisitions to maximize the acquisition record size. This is intended to improve clock recovery and eye measurement accuracy.
Specifies the analog channel input on which to perform the real-time eye analysis.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Analog channel input to use for the real-time eye analysis. |
Enables or disables the real-time eye analysis display.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets whether the real-time eye analysis display is enabled or disabled. |
Returns the number of UI intervals folded into the real-time eye analysis.
Saves the current arbitrary waveform to an internal location or to a file on a USB storage device. The waveform source is selected with <wavegen_id>.
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | - | - | 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 as part of <file_name>, it must be ".html".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the file name. |
Specifies the source for SAVE operations. The filename is the file's base name only, without path information or an extension.
| Name | Type | Values | Description |
|---|---|---|---|
| <base_name> | string | - | Quoted ASCII string that supplies the file base name. |
Saves an image. Set :SAVE:IMAGe:FORMat before using it; if a file extension is included in <file_name>, the format may be changed to match a valid image extension.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the file name. |
Controls whether oscilloscope factors are output along with the image. Factors are written to a separate .txt file with the same path and base name.
| Name | Type | Values | Description |
|---|---|---|---|
| factors | enum | OFF | 0 | ON | 1 | Enables or disables output of oscilloscope factors along with the image. |
Sets the image format type. The query returns the selected image format type; when NONE is returned, it indicates that a waveform data file format is currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BMP | BMP24bit | BMP8bit | PNG | Image format type to set. |
Controls whether the graticule colors are inverted or not.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 0 | ON | 1 | Sets whether graticule colors are inverted. |
Sets the image palette color. The query returns the selected image palette color.
| Name | Type | Values | Description |
|---|---|---|---|
| palette | enum | COLor | GRAYscale | Selects the image palette color. |
Saves the Lister display data to a file. If a file extension is provided in the <file_name>, it must be ".csv".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the output file name. |
Saves a mask. If a file extension is provided as part of <file_name>, it must be ".msk".
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | - | - | Destination file specification, either an internal location or a file name. |
Saves multi-channel waveform data to a file. The file can be opened by the N8900A Infiniium Offline oscilloscope analysis software.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | 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 output file name. |
Sets the present working directory for save operations.
| Name | Type | Values | Description |
|---|---|---|---|
| path_name | string | - | Quoted ASCII string specifying the directory path. |
Saves analysis results to a comma-separated values (*.csv) file on a USB storage device. Use the :SAVE:RESults:FORMat commands to choose which analysis result types are written; multiple selected types are saved to the same file separated by a blank line.
| Name | Type | Values | Description |
|---|---|---|---|
| file_specopt | string | - | File specification for the CSV output file. |
Specifies whether color grade bin counts 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 | Turns color grade bin counts off or on in saved analysis results. |
Specifies whether cursor values will be included when analysis results are saved using :SAVE:RESults:[STARt]. The saved results may include multiple analysis result types in the same file, separated by a blank line.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether cursor values are included in saved analysis results. |
Specifies whether histogram statistics are included when analysis results are saved. Analysis results are saved using :SAVE:RESults:[STARt], and multiple saved result types are written to the same file separated by a blank line.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether histogram statistics are saved. |
Specifies whether mask statistics are included when analysis results are saved using :SAVE:RESults:[STARt]. Other :SAVE:RESults:FORMat commands control which other result types are saved.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns mask statistics saving off or on. |
Specifies whether measurement results will be included when analysis results are saved. The saved results use the :SAVE:RESults:[STARt] command and may be combined with other analysis result types in the same file.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns measurement-results saving off or on. |
Specifies whether found search event times are included when analysis results are saved. The corresponding query returns whether this inclusion is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables saving found search event times with analysis results. |
Specifies whether segmented memory acquisition times will be included when analysis results are saved. Analysis results are saved using the :SAVE:RESults:[STARt] command.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns segmented-memory acquisition times off or on in saved 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 | - | Internal location or quoted ASCII file name to save the setup to. |
:SAVE[:SETup[:STARt]] [<file_spec>]
Saves oscilloscope waveform data to a file. Set :SAVE:WAVeform:FORMat before saving; if the specified file extension conflicts with the format, the format may be changed if the extension is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Quoted ASCII string specifying the output file name. |
:SAVE:WAVeform[:STARt] [<file_name>]
Sets the waveform data format type used for saved waveform files. The query returns the selected waveform data format type.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | ASCiixy | CSV | BINary | Waveform data format to save. |
Sets the waveform data length, that is, the number of points saved. When :SAVE:WAVeform:LENGth:MAX is 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 specifies the number of waveform data points saved.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Enables or disables saving the maximum number of waveform data points. |
Specifies which acquired segments are included when waveform data is saved in segmented memory. ALL saves all acquired segments; CURRent saves only the currently selected segment.
| Name | Type | Values | Description |
|---|---|---|---|
| option | enum | ALL | CURRent | Selects which segments are included in the saved waveform. |
Selects the source to be saved as a reference waveform file. 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 in <file_name>, it must be ".h5".
| Name | Type | Values | Description |
|---|---|---|---|
| file_nameopt | string | - | Reference waveform file name to save to. |
Selects the image area used by the :SAVE:IMAGe? query. The query returns SCR when saving images, and GRAT when saving setups or waveform data.
Turns displaying of the serial decode bus on or off. The command is only valid when a serial decode option has been licensed.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Enables or disables display of 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 the ARINC 429 decode and trigger options to preset values. 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. It does not affect the SDI and SSM fields, which are always displayed in binary, or the Label field, which is always displayed in octal.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | Selects the ARINC 429 base display format. |
Sets the user-defined A429 baud rate. 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 setting. |
Returns the error count.
Resets the word and error counters.
Returns the word count.
Specifies the ARINC 429 word decode format. The query returns the current format setting.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | LDSDi | LDSSm | LDATa | Sets the word decode format. |
Specifies the ARINC 429 signal type for the selected bus. The query returns the current signal type setting.
| Name | Type | Values | Description |
|---|---|---|---|
| signal | enum | A | B | DIFFerential | Selects the signal type: Line A, Line B, or Differential (A-B). |
Sets the source of the ARINC 429 signal for the selected serial bus. The query returns the currently set source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Source channel for the ARINC 429 signal. |
Sets the ARINC 429 signal speed. LOW is 12.5 kb/s, HIGH is 100 kb/s, and USER enables a user-defined baud rate using :SBUS<n>:A429:BAUDrate.
| Name | Type | Values | Description |
|---|---|---|---|
| speed | enum | LOW | HIGH | USER | ARINC 429 signal speed setting. |
Defines the ARINC 429 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, hex, octal, or string form. |
Defines the ARINC 429 data pattern resource from a binary string parameter. 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, where each character is 0, 1, or X; the length depends on the ARINC 429 format. |
Defines the ARINC 429 two-bit SDI pattern resource from a binary string parameter. The specified SDI is only used if :SBUS<n>:A429:FORMat includes the SDI field.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string pattern; the manual specifies "nn" where n is {0, 1, X}, length always 2 bits. |
Defines the ARINC 429 two-bit SSM pattern resource from a 2-bit string. The specified SSM is only used if :SBUS<n>:A429:FORMat includes the SSM field.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Two-bit binary string where n ::= {0 | 1 | X}, length always 2 bits. |
Defines a range of ARINC 429 label values used when the LRANge trigger type is selected. The query returns the current label values in decimal format.
| Name | Type | Values | Description |
|---|---|---|---|
| min | integer | 0 - 255 | Minimum label value in the range; may be entered as decimal, hexadecimal, octal, or string format. |
| max | integer | 0 - 255 | Maximum label value in the range; may be entered as decimal, hexadecimal, octal, or string format. |
Sets the ARINC 429 trigger condition for :SBUS<n>:A429:TRIGger. The query returns the current trigger condition.
| 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.
Returns the Spec error count, defined as the Ack + Form + Stuff + CRC errors count.
Returns the total frame count.
Queries the percent utilization of the CAN counter.
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 decode display format. |
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 sample point is specified as an even-numbered percentage from 30 to 90 in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 30 - 90 | CAN FD sample point as an even-numbered percentage from 30 to 90 in NR3 format. |
Selects the CAN FD frame decode standard used for 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 to use. |
Sets the CAN sample point, the percentage of the bit time at which the bit level is sampled to determine dominant or recessive state. The sample point is specified as a percentage of the bit time from 30.0 to 90.0.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 30.0 - 90.0 | Percentage of the bit time where the bit level is sampled. |
Sets the standard baud rate of the CAN signal. Values are rounded to the nearest 100 b/s increment when needed; 5 Mb/s is also allowed, but fractional baud rates between 4 Mb/s and 5 Mb/s are not allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 10000 - 5000000 | Baud rate to set for the CAN signal, in 100 b/s increments from 10000 to 4000000, or 5000000. |
Sets the CAN signal type when :SBUS<n>:CAN:TRIGger is set to SOF. The query returns the current CAN signal type.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CANH | CANL | RX | TX | DIFFerential | DIFL | DIFH | CAN signal type to use. |
Sets the CAN FD baud rate. If the value is not divisible by 100 b/s, it is rounded to the nearest baud rate divisible by 100 b/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 10000 - 10000000 | CAN FD baud rate 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 bus. The query returns the current CAN trigger condition.
| 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 trigger ID filtering. |
Defines the CAN data pattern resource according to the string parameter. The pattern, along with the data length set by :SBUS<n>:CAN:TRIGger:PATTern:DATA:LENGth, controls the data pattern searched for in each CAN message.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string of 0, 1, and X characters, or hexadecimal string prefixed with 0x using hexadecimal digits and X characters. |
Specifies the DLC value to be used in CAN FD data trigger mode. A valid FD value may be set, or -1 may be used 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 is used with :SBUS<n>:CAN:TRIGger:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Number of bytes in the CAN data string, expressed in NR1 format. |
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 for the CAN FD data trigger. |
Defines the CAN identifier pattern resource from a string parameter. The pattern string is always 29 bits; only 11 bits are used when the ID mode is STANdard, and longer strings are truncated to 29 bits.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CAN identifier pattern string, either binary using 0, 1, and X don't-care characters, or hexadecimal when prefixed with 0x. |
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 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. The query returns the specified message.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string specifying the trigger message. |
Specifies the signal to trigger on when CAN 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 identifying the signal to trigger on. |
Specifies the signal value to trigger on when CAN symbolic data has been loaded into the oscilloscope and the CAN trigger mode is set to MSIGnal. The query returns the specified signal value.
| Name | Type | Values | Description |
|---|---|---|---|
| data | real | - | Value in NR3 format. |
Sets the CXPI baud rate for the selected SBUS channel. The baud rate can be set from 9600 b/s to 40000 b/s in 100 b/s increments; the default is 20 kb/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 9600 - 40000 | Baud rate setting for the CXPI signal. |
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 |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Parity display setting. |
Selects the oscilloscope channel connected to the CXPI signal line for bus n. The query returns the selected oscilloscope channel source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Oscilloscope channel to use as the CXPI source. |
Sets the CXPI 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 specified bus. The query returns the current CXPI 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 use. |
Enables or disables modification of the CXPI trigger so it occurs only for a specified ID when triggering on CRC Field Errors, Inter-Byte Space Errors, Framing Errors, or Data Length Errors.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Turns the ID filter off or on. |
Specifies whether CXPI data triggers fire when the special PTYPE byte is present or absent. Use ON/1 to trigger on the PTYPE byte, or OFF/0 to trigger when it is not present.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether the trigger responds to the presence of the special PTYPE byte. |
Sets the CXPI trigger pattern data value for data-based triggering. The value is specified as a quoted binary-format string, and the query returns the currently specified data value in the same format.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data pattern value, expressed as a quoted binary-format string using 0, 1, or X; an alternate quoted hex-format form is also shown in the syntax notes. |
Specifies the length of the CXPI trigger pattern data, in bytes. The valid range is 0 to 12 bytes and is limited by the DLC setting of :SBUS<n>:CXPI:TRIGger:PATTern:INFO:DLC.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 0 - 12 | Length of the data to trigger on. |
Sets the starting byte location for CXPI pattern-data triggering. For long frames, it specifies where within the trigger specification the data value should be found.
| Name | Type | Values | Description |
|---|---|---|---|
| start | integer | 0 - 124 | Starting byte location to use for the pattern data trigger. |
Sets the CXPI trigger pattern frame ID value for the selected bus. The query returns the specified frame ID value in quoted binary format.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Frame ID value to use, expressed as a binary string of 0, 1, and X, or as a hex string prefixed with 0x. |
Sets the Count (CT) bits of the CXPI frame trigger pattern. The value is a two-bit binary string.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Two-bit binary CT value to trigger on. |
Sets the data length code for a CXPI trigger pattern on data-capable trigger types. The allowed range depends on whether the trigger is in DATA mode or LDATa mode.
| Name | Type | Values | Description |
|---|---|---|---|
| dlc | integer | -1 - 15 | DLC value for the trigger pattern; -1 means don't care in DATA mode. |
Specifies the Network Management (NM) value of the CXPI frame to trigger on. The NM value is a two-bit binary value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Two-bit binary NM value, written as "nn" where n ::= {0 | 1 | X}. |
Automatically configures oscilloscope settings to facilitate FlexRay triggering and serial decode. It sets the selected source channel impedance to 50 Ohms, probe attenuation to 10:1, trigger level to -300 mV, turns on trigger Noise Reject and Serial Decode, and sets the trigger to the specified serial bus.
Sets the FLEXray baud rate for the specified bus. The query returns the current baud rate setting.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 2500000 - 10000000 | Baud rate to set: 2.5 Mb/s, 5 Mb/s, or 10 Mb/s. |
Specifies the FlexRay bus channel as A or B. The query returns the current bus channel setting.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | A | B | Selects the bus channel for the FlexRay signal. |
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 for the FlexRay signal.
| 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. |
Automatically configures oscilloscope settings as shown on the display for the selected event trigger.
Sets the frame ID used by the Byte Start Sequence (BSS) event trigger. This setting is valid only when trigger mode is EVENt and EVENt:TYPE is BSS.
| Name | Type | Values | Description |
|---|---|---|---|
| frame_id | enum | ALL | Frame ID to use for the BSS event trigger. |
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. The 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 | Selects the cycle count repetition to trigger on. |
Sets the FlexRay frame ID to trigger on. The frame ID setting is only valid when the FlexRay trigger mode is set to FRAMe.
| Name | Type | Values | Description |
|---|---|---|---|
| frame_id | enum | ALL | 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 to trigger on. |
Selects the data alignment of the I2S bus 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 | Selects the I2S data alignment. |
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 | Sets 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. |
Sets the width of the I2S receiver (decoded) data word. The width can be set from 4 bits to 32 bits.
| Name | Type | Values | Description |
|---|---|---|---|
| receiver | integer | 4 - 32 | I2S receiver data word width in bits. |
Controls which signal is used as the I2S 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 clock source for DSO models. |
Controls which signal is used as the serial data (SDATA) source for the serial decoder and/or trigger in I2S mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Selects the I2S data 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 | DIGital<d> | Selects the WS source; CHANnel<n> or EXTernal on DSO models, and CHANnel<n> or DIGital<d> on MSO models. |
Sets the I2S trigger operator for :SBUS<n>. The operator can be one of equality, inequality, less/greater than, in-range, out-of-range, increasing, or decreasing trigger modes.
| Name | Type | Values | Description |
|---|---|---|---|
| operator | enum | EQUal | NOTequal | LESSthan | GREaterthan | INRange | OUTRange | INCReasing | DECReasing | Selects the I2S trigger operator. |
Specifies the audio channel to trigger on for the I2S trigger. 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 entered as a string whose interpretation depends on :SBUS<n>:I2S:TRIGger:PATTern:FORMat, and the query returns the currently specified pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | I2S trigger data pattern string. |
Sets the entry and query number base used by the :SBUS<n>:I2S:TRIGger:PATTern:DATA command. The default base is DECimal.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | DECimal | Number base to use for I2S pattern data. |
Sets the lower and upper range boundaries used by the INRange, OUTRange, INCReasing, and DECreasing trigger conditions. 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 value. |
| upper | integer | - | Upper range boundary value. |
Sets the width of the transmitted I2S data word anywhere from 4 bits to 32 bits. The query returns the currently set I2S transmitted data word width.
| Name | Type | Values | Description |
|---|---|---|---|
| word_size | integer | 4 - 32 | Width of the transmitted I2S data word. |
Selects the polarity of the I2S word select (WS) signal. Use LEFT when a low WS state indicates left-channel data, or RIGHt when a low WS state indicates right-channel data.
| Name | Type | Values | Description |
|---|---|---|---|
| low_def | enum | LEFT | RIGHt | Selects the WS polarity. |
Determines whether the Read/Write bit is included as the LSB in the display of the IIC address field of the decode bus. The query returns the current IIC address width setting.
| Name | Type | Values | Description |
|---|---|---|---|
| size | enum | BIT7 | BIT8 | Sets the IIC address width displayed for the decode bus. |
Sets the source for the IIC serial clock (SCL). The query returns the current source.
| 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; DSO models use CHANnel<n> or EXTernal, and MSO models use CHANnel<n> or DIGital<d>. |
Sets the address for IIC data. The address may be specified 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 | numeric | 0x00 - 0x7F | Address value for IIC data; may also be a 10-bit hexadecimal value up to 0x3FF, or the don't care address (-1 or 0xFFFFFFFF). |
Sets the IIC data pattern for trigger qualification. The data value may be entered as an integer or as a hex string in the form "0xnn"; use -1 or 0xFFFFFFFF for the don't-care pattern to ignore the data value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | 0x00 - 0x0FF | IIC data value to set; may be an integer or a hex string formatted as "0xnn". |
Sets IIC data 2 for the trigger pattern. The value can be given as an integer or as a hex string in the form "0xnn"; use -1 or 0xFFFFFFFF for the don't-care data pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0x00 - 0x0FF | IIC data 2 pattern value. |
Sets the IIC data qualifier when `TRIGger:IIC:TRIGger[:TYPE]` is set to `READEprom`. The query returns the current IIC data qualifier value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | LESSthan | GREaterthan | IIC data qualifier to set. |
Sets the IIC trigger type for the selected serial 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 | Selects the IIC trigger type. |
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 | Display type for LIN symbolic data. |
Determines whether parity bits are included as the most significant bits in the display of the LIN Frame Id field. The query returns the current LIN parity bits display setting of the serial decode bus.
| Name | Type | Values | Description |
|---|---|---|---|
| display | enum | 1 | ON | 0 | OFF | Sets whether parity bits are shown in the LIN Frame Id display. |
Sets the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The sample point is a percentage of the bit time from the beginning to the end of the bit time.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 60 | 62.5 | 68 | 70 | 75 | 80 | 87.5 | LIN sample point in NR3 format. |
Sets the standard baud rate of the LIN signal. If a value is not divisible by 100 b/s, it is rounded to the nearest 100 b/s increment.
| 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, or queries the current LIN standard setting. Supported values are LIN13, LIN13NLC, and LIN20.
| Name | Type | Values | Description |
|---|---|---|---|
| std | enum | LIN13 | LIN13NLC | LIN20 | Specifies the LIN standard to use. |
Sets the LIN sync break length to 11, 12, or 13 clock lengths. The query returns the current LIN sync break setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 11 - 13 | Sets the length of the LIN sync break in clock lengths. |
Sets the LIN trigger condition for the selected serial bus. The query returns the current LIN trigger condition.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | SYNCbreak | ID | DATA | PARityerror | CSUMerror | FRAMe | FSIGnal | Sets the LIN trigger condition. |
Defines the LIN identifier searched for in each CAN message when LIN trigger mode is set to frame ID. Setting the ID to -1 results in 0xXX, equivalent to all IDs.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 63 | 7-bit LIN identifier, entered as decimal, nondecimal, or string notation. |
Sets the LIN trigger data pattern searched for in each LIN data field. The pattern is entered as a string whose format depends on the base set by :SBUS<n>:LIN:TRIGger:PATTern:FORMat; the query returns the currently specified pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | LIN trigger data pattern string. |
Sets the number of 8-bit bytes in the LIN data string. The value is between 1 and 8 bytes (64 bits) 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. |
Sets the entry number base used by :SBUS<n>:LIN:TRIGger:PATTern:DATA. The default base is BINary.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | BINary | HEX | DECimal | Entry number base for LIN pattern data. |
Specifies the LIN symbolic message to trigger on when symbolic data has been loaded into the oscilloscope and LIN trigger mode is set to FRAMe or FSIGnal.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string identifying 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. |
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 | - | Value in NR3 format. |
Automatically sets options for decoding and triggering on MIL-STD-1553 signals. It sets the trigger thresholds to ±1/3 division based on the source channel's current V/div setting, turns noise reject off, sets probe attenuation to 10.0, and turns 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 | Base to use for the MIL-STD-1553 decode display. |
Sets the source of the MIL-STD 1553 signal for the selected bus channel. Use the trigger level high and low 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 is RTA11 (RTA + 11 Bits). The pattern data is an 11-character string made up of 0, 1, and X.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 11-bit trigger pattern string composed of 0, 1, and X. |
Sets the Remote Terminal Address (RTA) to trigger on when the trigger type has been set to RTA or RTA11. Setting the value to -1 selects don't cares (0xXX).
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | -1 - 31 | Remote Terminal Address to trigger on; may be given as decimal, nondecimal (#Hnn), or string ("0xnn"). |
Specifies the type of MIL-STD-1553 trigger to use for the selected serial bus. 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 to use. |
Sets the decode number base for the Manchester 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. |
:SBUS<n>:MANChester:BASE?
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 bit order used for Manchester bus transmission 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 bit or least significant bit is transmitted first. |
Specifies the format of the Manchester bus display.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BIT | WORD | Sets the Manchester bus display format. |
Sets the number of words in the data field of the Manchester protocol definition when the display format is WORD. AUTO is allowed only when the trailer field size is 0.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AUTO | Selects automatic data field 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 header field bits. |
Sets 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 bits, in NR3 format. |
Specifies the polarity of the Manchester signal. A falling edge can encode logic 1, or a rising edge can encode logic 1 depending on the 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 selected oscilloscope channel source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Oscilloscope channel source to connect to the Manchester signal line. |
Specifies the number of sync bits for the Manchester signal.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 255 | Number of sync bits. |
Sets 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. |
Sets the tolerance for the Manchester signal in terms of the percentage of the bit period. The query returns the current tolerance setting.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 5 - 30 | Tolerance percentage for the Manchester signal, in NR1 format. |
Specifies the Manchester trigger mode. The query returns the current trigger mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SOF | VALue | MERRor | Trigger mode to use for Manchester triggering. |
Specifies the trigger value used when VALue trigger mode is selected. The value bit order is always as the bits arrive (MSB first), regardless of the serial decode bit order setting.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Trigger value to set, formatted as a binary string or as 0x-prefixed hexadecimal text with support for X and $ digits. |
Sets the bit width (length) of the value to trigger on when VALue trigger mode is selected. The actual trigger value is set with :SBUS<n>:MANChester:TRIGger:PATTern:VALue:DATA.
| 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 of the Manchester protocol definition. |
Sets the number of bits per word in the data field of the Manchester 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. |
Sets the decode number base for the NRZ bus decode and Lister display. When the display format is WORD, the base may be HEX, DECimal, or ASCii; when the display format is BIT, only BINary is allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | HEX | DECimal | ASCii | BINary | Decode number base to use for the NRZ bus decode and Lister display. |
Specifies the baud rate of the NRZ signal.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 5000 - 5000000 | Baud rate for the NRZ signal. |
Sets the bit order used for transmission on the NRZ bus 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 bit or least significant bit is transmitted first. |
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 | Sets the NRZ bus display format. |
Sets 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 of the NRZ protocol definition. |
Sets the total frame size of the NRZ signal when the NRZ bus display format is BIT. The value is equivalent to the sum of the header, data, and trailer field sizes in WORD format.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 2 - 255 | Total NRZ frame size in bits, expressed 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 bit setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 32 | Number of bits in the header field. |
Specifies the minimum idle time or inter-frame gap time in terms of the number of bits. The value is entered in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| bits | real | 1.50 - 32.00 | Minimum idle time in bits. |
Specifies the idle state of the NRZ signal. The query returns the idle state setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | LOW | HIGH | Idle state of the NRZ signal. |
Specifies the polarity of the NRZ signal for the selected serial bus. HIGH uses a positive voltage to encode logic 1, while LOW uses a negative voltage to encode logic 1.
| Name | Type | Values | Description |
|---|---|---|---|
| logic | enum | HIGH | LOW | Polarity of the NRZ signal. |
Selects the oscilloscope channel connected to the NRZ signal for the specified bus channel. The query returns the selected source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Selects the source channel for the NRZ signal. |
Specifies the number of start bits for the NRZ signal.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 255 | Number of start bits to set for the NRZ signal. |
Specifies the NRZ trigger mode. SOF triggers at the start of an NRZ frame; VALue triggers on specified bit values.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SOF | VALue | Trigger mode. |
Specifies the trigger value used when VALue trigger mode is selected. The value is entered as a bit string, and the bit width is set by :SBUS<n>:NRZ:TRIGger:PATTern:VALue:WIDTh.
| Name | Type | Values | Description |
|---|---|---|---|
| value | string | - | Trigger value as a string of binary digits or hexadecimal format. |
Sets the bit width used for the VALue trigger pattern. 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 bits setting.
| Name | Type | Values | Description |
|---|---|---|---|
| #bits | integer | 0 - 32 | Number of bits in the trailer field of the NRZ protocol definition. |
Sets the number of bits per word in the data field of the 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, in NR1 format. |
Specifies the nominal clock period (tick) for SENT output. The query returns the current clock period setting.
| Name | Type | Values | Description |
|---|---|---|---|
| period | real | 500 ns - 300 us | The nominal clock period (tick), specified in NR3 format. |
Sets the CRC format used for SENT fast channel messages and short serial message CRCs. Legacy (2008) or Recommended (2010) may be selected.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | LEGacy | RECommended | CRC format to use. |
Sets the number base used by the SENT decoder for display. The selection applies to the Lister and decode line displays; when SYMBolic is selected, Fast Channel Signals are shown as calculated physical values and CRC/Slow Channel information is displayed in hex.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | HEX | DECimal | SYMBolic | Number base used by the decoder. |
Specifies the SENT message decode/triggering format for bus source n. The setting 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 | Idle state of the SENT bus. |
Sets the number of nibbles in a SENT message, from 1 to 6. The query returns the current nibbles 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 in SENT. OFF disables pause pulses, ON adds them so frames arrive at a regular interval, and SPC indicates Short PWM Code mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | SPC | Pause pulse mode setting. |
Specifies whether the given signal is on or off. The query returns the signal on/off setting.
| Name | Type | Values | Description |
|---|---|---|---|
| s | integer | 1 - 6 | Signal index in NR1 format. |
Specifies the bit length of the signal being defined. The query returns the current signal bit length setting.
| Name | Type | Values | Description |
|---|---|---|---|
| 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 |
|---|---|---|---|
| s | integer | 1 - 6 | Fast Channel Signal index. |
| multiplier | real | 1 - 24 | Multiplier value used in the physical-value calculation. |
Sets the offset value for the Fast Channel Signal. When the display mode is SYMBolic, this value is used with the multiplier and signal value to calculate the physical value displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | integer | 1 - 24 | Offset value for the Fast Channel Signal. |
Specifies the nibble order of the defined signal for Fast Signal definition, either Most Significant Nibble first or Least Significant Nibble first.
| Name | Type | Values | Description |
|---|---|---|---|
| order | enum | MSNFirst | LSNFirst | Sets the nibble order of the signal being defined. |
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 for the Fast Signal. |
Specifies the input channel for SENT decode and triggering. The query returns the specified SENT input source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input source for SENT decode and triggering. |
Specifies the tolerance used to determine whether the sync pulse is valid. Valid values range from 3% to 30%.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 3 - 30 | Tolerance setting in percent. |
Specifies the SENT trigger mode for the selected bus. 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 | Sets the SENT trigger mode. |
Specifies the status and data nibbles that will be triggered on when the FCData trigger mode is chosen. The query returns the fast channel data trigger setting.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Status and data nibble pattern to use for 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 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 ID range depends on the 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. SHORt selects the 4-bit ID, 16-bit data format; LONG selects the 8-bit ID, 12-bit data format.
| Name | Type | Values | Description |
|---|---|---|---|
| length | enum | SHORt | LONG | Selects the Slow Message Enhanced message ID and data length format. |
Sets the trigger tolerance variation percentage considered a violation for sent bus decoding. The allowed range is limited to 1-28 percent, and must also be no greater than the associated :SBUS<n>:SENT:TOLerance setting minus two percent.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | integer | 1 - 28 | Trigger tolerance variation percent, in NR1 format. |
Selects the SPI decode bit order used for displaying data in the serial decode waveform and in the Lister. The query returns the current SPI decode bit order.
| Name | Type | Values | Description |
|---|---|---|---|
| order | enum | LSBFirst | MSBFirst | Bit order to use, least significant bit first or most significant bit first. |
Specifies the rising edge (POSitive) or falling edge (NEGative) of the SPI clock source that will clock in the data.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the SPI clock edge used to clock in data. |
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 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 value is set by :SBUS<n>:SPI:CLOCk:TIMeout; NOTC is deprecated and equivalent to NCHipselect.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHIPselect | NCHipselect | NOTC | TIMeout | SPI framing value to set. |
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 | DIGital<d> | Source for the SPI serial clock. |
Sets the SPI frame source when :SBUS<n>:SPI:FRAMing is set to CHIPselect or NOTChipselect. The query returns the current frame source for the SPI serial frame.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | 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 depends on the model family.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for the SPI serial MISO data. |
Sets the source for the SPI serial MOSI data. The allowed source depends on the model family: DSO models accept a channel or external source, while MSO models accept a channel or digital source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Source for the SPI serial MOSI data. |
Defines the SPI data pattern resource from a string parameter. The string may be binary (`0`, `1`, `X`, `$`) or hexadecimal when prefixed with `0x`; the data width should be set before 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 anywhere from 4 bits to 64 bits. Set this before :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 64 | Width of the SPI data pattern in bits. |
Defines the SPI data pattern resource according to the supplied string. The pattern, together with the data width, controls the data pattern searched for in the data stream; if the string starts with "0x", it is interpreted as hexadecimal, otherwise as binary.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | SPI data pattern string made up of binary or hexadecimal characters with don't-care X and $ characters. |
Sets the width of the SPI data pattern for MOSI, from 4 bits to 64 bits. Set this 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 on MOSI data or MISO data. The query returns the current SPI trigger type setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MOSI | MISO | Selects the SPI trigger data line. |
Determines the number of bits in a word of SPI data. The query returns the current SPI decode word width.
| Name | Type | Values | Description |
|---|---|---|---|
| word_width | integer | 4 - 16 | Number of bits in a word of data for SPI. |
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. |
Selects the UART bit rate, in bps, for the serial decoder and/or trigger when in UART mode. The baud rate may be set from 100 b/s to 8 Mb/s, or to 10 Mb/s or 12 Mb/s.
| Name | Type | Values | Description |
|---|---|---|---|
| baudrate | integer | 100 - 12000000 | UART bit rate in bits per second. |
Specifies the bit order used by the physical Tx and Rx input signals for the serial decoder and/or trigger when in UART mode. LSBFirst sends the least significant bit first; MSBFirst sends the most significant bit first.
| Name | Type | Values | Description |
|---|---|---|---|
| bitorder | enum | LSBFirst | MSBFirst | Sets the UART bit transmission order. |
Returns the UART error frame count.
Resets the UART frame counters.
Returns the UART Rx frame count.
Returns the UART Tx frame count.
Sets the byte value used for 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 | <decimal> | <nondecimal> | Byte value used for framing, or OFF to disable framing. |
Selects the parity used with each message byte for the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| parity | enum | EVEN | ODD | NONE | Parity to be used with each message byte. |
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. The query returns the current source for the UART Rx signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Selects the UART Rx source signal. |
Controls which signal is used as the Tx source by the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | DIGital<d> | Selects the UART Tx source signal. |
Sets the front panel UART/RS232 trigger setup data selection option. ASCII selects data selection from ASCII values, and HEX selects hexadecimal values.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Selects the UART/RS232 trigger data base. |
Selects the burst value (Nth frame after idle period) for the UART trigger. The value can be OFF or an integer from 1 to 4096.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | OFF | 1 to 4096 in NR1 format | Burst value to use for UART trigger. |
:SBUS<n>:UART:TRIGger:BURSt <value> :SBUS<n>:UART:TRIGger:BURSt?
Selects the UART trigger data byte value used when the RD or TD trigger types are selected in UART mode. The value may be entered as a decimal, hexadecimal, binary, or quoted ASCII character.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | 8-bit trigger data byte value to select. |
Selects the UART burst trigger idle period when in UART mode. The allowed time range is 1 us to 10 s in NR3 format.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 1 us - 10 s | Idle period time for burst trigger. |
Selects the data qualifier for the UART trigger when :TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX. The query returns the current UART trigger qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | GREaterthan | LESSthan | Selects the UART trigger data qualifier. |
Selects the UART trigger type. When an RD or TD type is selected, :SBUS<n>:UART:TRIGger:DATA and :SBUS<n>:UART:TRIGger:QUALifier 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 | UART trigger type to select. |
Determines the number of bits (5-9) for each message byte for the serial decoder and/or trigger when in UART mode.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 5 - 9 | Sets the UART width in bits. |
Determines the base used for the 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 | Base to use 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> | Source signal to use as the USB D- source for the selected bus. |
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 signal source for USB D+. |
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> | Differential source channel. |
Sets 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 to select. |
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 condition to set. |
Sets the 7-bit Address portion of the trigger for the selected bus, in binary or hex. The query returns the specified Address portion of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 7-bit address value, either as a binary string of 0/1/X digits or as a hexadecimal string in the form 0xnn. |
Specifies the CRC portion of the trigger for the selected USB bus, in binary or hex. The query returns the specified CRC portion of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CRC value in either binary form "nnnnn" or hex form "0xnn". |
Specifies the Data portion of the trigger for the selected bus, in binary or hex. Use :SBUS<n>:USB:TRIGger:DATA:LENGth to set the data value length.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hex data string, with binary form "nnnn..." using 0, 1, or X and hex form "0xn..." using 0-9, A-F, X, or $. |
Sets 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 of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 4-bit endpoint value, expressed as either binary or hexadecimal 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 of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hex ET value, formatted as "nn" or "0xn". |
Specifies the 11-bit Frame portion of the trigger for the selected bus, in binary or hex. The query returns the specified Frame portion of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 11-bit Frame value in binary or hexadecimal form. |
Specifies the 7-bit Hub Address portion of the trigger for the selected bus, in binary or hex. The query returns the specified Hub Address portion of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 7-bit Hub Address value, entered either as a binary string "nnnnnnn" or as hexadecimal "0xnn". |
Specifies the 4-bit PID check portion of the trigger for the selected bus, in binary or hex. See the corresponding :SBUS<n>:USB:TRIGger:PID commands for setting the PID.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 4-bit PID check portion of the trigger, expressed as binary or hex. |
Specifies the USB data PID to trigger on for the selected bus. The PID does not include the check value; use :SBUS<n>:USB:TRIGger:PIDCheck for that.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | DATA0 | DATA1 | DATA2 | MDATa | 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 by :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 separately by :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 PID does not include the PID check value, which is set with :SBUS<n>:USB:TRIGger:PIDCheck.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | OUT | IN | SETup | SOF | USB token PID to trigger on. |
Specifies the 7-bit Port portion of the USB 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 formatted as binary or hexadecimal text. |
Specifies the 1-bit SC portion of the trigger for the selected bus, in binary or hex. The query returns the specified SC portion of the trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary or hex SC value, where binary forms use 0, 1, or X and hex forms use 0, 1, X, or $. |
Specifies the 2-bit S and E or U portion of the trigger for the selected bus, in binary or hex.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 2-bit S and E or U portion of the trigger value, entered as binary or hexadecimal text. |
Selects the USB PD waveform source. You can use analog channels.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | Selects the USB PD waveform source. |
Selects the USB PD trigger mode for the specified bus. The query returns the currently selected trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | PSTart | EOP | SOP | SPRime | SDPRime | SPDebug | SDPDebug | HRST | CRST | CRCerror | PERRor | HEADer | Selects the USB PD trigger mode. |
Selects the USB Power Delivery trigger header type when Header Content trigger mode is selected. The query returns the currently selected header type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | CMESsage | DMESsage | EMESsage | VALue | Selects the header type. |
Selects the control message type used when Header Content 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 for the trigger header when Header Content trigger mode and Data Message header type are selected. The query returns the currently 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 extended message type used when Header Content trigger mode and Extended Message header type are selected. The query returns the selected extended message type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | SCX | STATus | GBCap | GBSTatus | BCAP | GMINfo | MINFo | SREQuest | SRESponse | FREQuest | FRESponse | PSTatus | CINFo | CCODes | Extended message type to select. |
Sets the user-defined header value used when Header Content trigger mode is selected and the Value type is chosen. The query returns the specified user-defined header value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | User-defined header value, entered as a quoted binary-format string of 0, 1, and X characters, optionally with a 0x prefix. |
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 | SPPrime | SDPPrime | Additional qualifier for the Header Content trigger. |
Sets the LIN signal type for the selected serial bus. The only legal value is LIN.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | LIN | RX | TX | Specifies the LIN signal type. |
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 | DIGital<d> | Source for the SPI serial MOSI data. |
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. |
Selects the search mode. The command 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 used for the search. The query returns the current slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | Slope of the edge 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 use as the search source. |
Sets the minimum pulse width duration for the selected :SEARch:GLITch:SOURce. The query returns the minimum pulse width duration time for :SEARch:GLITch:SOURce.
| Name | Type | Values | Description |
|---|---|---|---|
| greater_than_time | real | s | Minimum pulse width duration value. |
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 to set. |
Sets the polarity for the glitch (pulse width) search.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Selects the glitch search polarity. |
Sets the mode of operation of the glitch (pulse width) search. The oscilloscope can search for 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 search is greater than, less than, or within a range of time values. |
Sets the pulse width duration range for the selected :SEARch: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 duration bound. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower pulse-width duration bound. |
Selects the channel on which to search for glitches (pulse widths). The query returns the current pulse width source, or "NONE" if all channels are off.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Channel to use as the glitch search source. |
Specifies the change in level (hysteresis) that must occur to be recognized as a peak. The threshold level units are determined by the :FUNCtion<m>[:FFT]:VTYPe command.
| 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.
| Name | Type | Values | Description |
|---|---|---|---|
| number | integer | 1 - 11 | Maximum number of peaks to find, in NR1 format. |
Selects the FFT math function waveform to search. The query returns the FFT math function waveform currently being searched.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | FUNCtion<m> | MATH<m> | FFT waveform source to search; must be an FFT waveform. |
Specifies the threshold level necessary to be considered a peak for FFT peak search. The threshold level units are determined by the :FUNCtion<m>[:FFT]:VTYPe command.
| 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 to use 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 on which to search for the runt pulse. The query returns the current runt search source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Search source channel, specified as CHANnel<n>. |
Specifies the runt pulse time value used when searching for runt pulses whose widths are greater than or less than a time. The value is entered as a floating-point NR3 number with optional time suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Time value used for runt pulse search. |
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 | Search transition slope to use. |
Selects the channel on which to search for edge transitions. The query returns the current transition search source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel to use as the transition search source. |
Sets the time of the transition to search for. Transitions greater than or less than this time can be searched for.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Time value for the transition to search for. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
:SEARch:TRANsition:TIME <time>[suffix] :SEARch:TRANsition:TIME?
Defines the ARINC 429 label value when labels are used in the selected search mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | ARINC 429 label value, entered in decimal, hex, octal, or string form. |
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 | ARINC 429 search mode condition to select. |
Defines the ARINC 429 data pattern resource according to the supplied binary string. The pattern controls the data pattern searched for in each ARINC 429 word; extra bits are truncated if the string is longer than specified by the :SBUS<n>:A429:FORMat setting.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string of bits 'nn...n' used to define the ARINC 429 data pattern resource. |
Defines the ARINC 429 two-bit SDI pattern resource according to the string parameter. The specified SDI is only used if the :SBUS<n>:A429:FORMat includes the SDI field.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string value in the form "nn", where n is 0 or 1; length is always 2 bits. |
Defines the ARINC 429 two-bit SSM pattern resource from a binary 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 for the two-bit SSM pattern; must be two bits long with each bit 0 or 1. |
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 search condition the Lister display searches for. |
Specifies the data value used when searching for Data Frame ID and Data. The length of the data value is set by :SEARch:SERial:CAN:PATTern:DATA:LENGth.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data value in the form "0xnn...n" where n is hexadecimal (0-9, A-F, X). |
Sets the length of the data value used when searching for Data Frame ID and Data. The data value itself is specified with :SEARch:SERial:CAN:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Data length in NR1 format. |
Sets 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". |
: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 :SEARch:SERial:CAN:PATTern:ID.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | STANdard | EXTended | Selects the CAN ID mode used for search. |
Specifies the CAN symbolic message to search for when CAN symbolic data has been loaded and CAN serial search mode is set to MESSage or MSIGnal. The query returns the specified message.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Quoted ASCII string specifying the message name. |
Specifies the CAN symbolic signal to search for when CAN symbolic data has been loaded and the 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 find, 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 find, formatted as "0xnn...n". |
:SEARch:SERial:FLEXray:DATA <string> :SEARch:SERial:FLEXray:DATA?
Sets the length of data values used when searching for FlexRay frames. The query returns the current data length setting.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 12 | Length of data values when searching for FlexRay frames. |
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 find. |
| frame # | integer | 1 - 2047 | Frame number to find. |
Selects the type of FlexRay information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | FRAMe | CYCLe | DATA | HERRor | FERRor | AERRor | Selects which FlexRay information type to search for. |
Specifies which audio channel to search for I2S events. The query returns the current channel setting.
| Name | Type | Values | Description |
|---|---|---|---|
| audio_ch | enum | RIGHt | LEFT | EITHer | Selects the audio channel used for the search. |
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 value format depends on the base selected with :SEARch:SERial:I2S:PATTern:FORMat.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Data word value to search for, formatted as decimal, binary, or hex 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. |
Specifies the data value range used when searching for I2S events in the INRange and OUTRange search modes. The parameters may be entered in any order; the smaller value becomes <lower> and the larger value becomes <upper>.
| Name | Type | Values | Description |
|---|---|---|---|
| lower | integer | - | Lower data value limit for the I2S search range. |
| upper | integer | - | Upper data value limit for the I2S 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 event to search for. |
Specifies address values when searching for IIC events. Use the integer -1 to set don't care values.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Address value to store; may be an integer or a string of 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 | integer | -1 | Data value used for the IIC pattern search. |
:SEARch:SERial:IIC:PATTern:DATA <value> :SEARch:SERial:IIC:PATTern:DATA?
Specifies the second data value used when searching for IIC events with two data values. Use the integer -1 to set a don't-care value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Second data value for the IIC pattern search; may be an integer or a string in 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 | Data value qualifier used for the search. |
Specifies the frame ID value when searching for LIN events. The query returns the current frame ID setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 63 | 7-bit frame ID value, accepted in decimal, nondecimal, or string form. |
Selects the type of LIN information to find in the Lister display. The query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | ID | DATA | ERRor | FRAMe | FSIGnal | Selects the LIN search mode. |
Sets the LIN pattern data value used when searching for LIN events. The number 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 is set with :SEARch:SERial:LIN:PATTern:DATA.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 1 - 8 | Length of the data value, in NR1 format. |
Sets 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 serial LIN pattern search data. |
Specifies the message to search for when LIN symbolic data has been loaded into the oscilloscope and the 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 and 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. The query returns the specified signal value.
| Name | Type | Values | Description |
|---|---|---|---|
| data | real | - | Signal value to search for, expressed in NR3 format. |
Selects the type of MIL-STD-1553 information to find in the Lister display. The corresponding query returns the currently selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | DSTArt | CSTArt | RTA | RTA11 | PERRor | SERRor | MERRor | Selects which MIL-STD-1553 information type to search for. |
Specifies the additional 11 bits used when searching for the MIL-STD-1553 Remote Terminal Address + 11 Bits. The query returns the current bit pattern setting.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Binary string of 11 bits, using only 0 and 1. |
Sets the Remote Terminal Address (RTA) used when searching for MIL-STD-1553 events. The value may be entered as a 5-bit decimal, hexadecimal, binary, or string-form representation from 0 to 31.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 31 | Remote Terminal Address value to use for the search. |
Specifies the status and data nibbles that will be searched for when the FCData search mode is chosen.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Status and data nibble search value in the form "0xn..." where n is {0,..,9 | A,..,F | X | $}. |
Specifies what SENT serial data condition the search function looks for when SENT serial decode is turned on and shown in the Lister. The query returns the current search mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FCData | SCMid | SCData | CRCerror | PPERror | Search mode to use for SENT serial decode. |
Sets the data value to search for in the Slow Channel Message ID and Data search mode. The query returns the current slow channel data search value setting.
| Name | Type | Values | Description |
|---|---|---|---|
| data | integer | -1 - 65535 | Data to search for; -1 means don't care. |
Specifies the slow channel ID to search for in the "Slow Channel Message ID" and "Slow Channel Message ID & Data" trigger modes. The ID can be 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 the SPI search uses MOSI data or MISO data. The query returns the current SPI search mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | MOSI | MISO | Selects whether the SPI search is on 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 hexadecimal string form "0xnn...n". |
Specifies the width of the data value in bytes when searching for SPI events. The data value is specified using the :SEARch:SERial:SPI:PATTern:DATA command.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 1 - 10 | Width of the data value in bytes. |
Specifies the data value used when searching for UART/RS232 events. The data value qualifier is set separately with :SEARch:SERial:UART:QUALifier.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | 8-bit integer data value, accepted in decimal, hexadecimal, binary, or quoted string format. |
Selects the type of UART/RS232 information to find in the Lister display. Use the query form to read the current search mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | RDATa | RD1 | RD0 | RDX | TDATa | TD1 | TD0 | TDX | PARityerror | AERRor | UART/RS232 search mode to find in the Lister display. |
Specifies the data value qualifier used when searching for UART/RS232 events. The query returns the current data value qualifier setting.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | EQUal | NOTequal | GREaterthan | LESSthan | Selects the UART/RS232 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 in the form "0xnn". |
Specifies the CRC portion of the USB serial search value in hex. The query returns the specified CRC portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | CRC portion of the search 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 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. |
Specifies the 4-bit Endpoint portion of the USB serial search value, in hex. The query returns the specified Endpoint portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Endpoint portion of the search value, formatted as a hex string. |
Specifies the 2-bit ET portion of the USB serial search value, in hex. The query returns the specified ET portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex string of the form "0xn" where n is one of 0, 1, 2, 3, X, or $. |
Specifies the 11-bit Frame portion of the USB search value in hex. The query returns the specified Frame portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | 11-bit Frame portion of the search value, formatted as "0xnnn". |
Specifies the 7-bit Hub Address portion of the USB serial 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 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. |
Sets the USB handshake PID to find. The HANDshake USB search mode is selected with :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 find. The special search mode is selected using :SEARch:SERial:USB:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| pid | enum | PING | PRE | ERR | SPLit | USB special PID to find. |
Specifies the USB token PID to find for serial USB search. The token 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 USB search value in hex.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex port value in the form 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 string 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 search value in hex. The query returns the specified S and E or U portion of the search value.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Hex-encoded search-value portion in the form "0xn". |
Sets the system date. Validity checking is performed to ensure that the date is valid.
| Name | Type | Values | Description |
|---|---|---|---|
| date | - | - | Date value in the form <year>,<month>,<day>. |
Returns the oscilloscope's Host ID as part of a quoted ASCII string. The exact returned format is product-specific, and portable programs should not parse its contents.
Writes a quoted ASCII string to a text box on-screen. Use `:SYSTem:DSP ""` to remove the message from the display.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII string to display, up to 75 characters. |
:SYSTem:DSP <string>
Outputs the next error number and text from the error queue. Repeated queries return errors in first-in, first-out order until the queue is empty, then return zero until another error occurs.
Disables or enables the front panel lock. LOCK ON is equivalent to sending a local lockout message over the programming interface.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns the front panel lock on or off. |
Sets the manufacturer-string portion of the identification string returned by *IDN?. The default manufacturer string is "KEYSIGHT TECHNOLOGIES".
| Name | Type | Values | Description |
|---|---|---|---|
| manufacturer_string | string | - | Quoted ASCII manufacturer string, up to 63 characters. |
Sets the manufacturer string to "KEYSIGHT TECHNOLOGIES".
Turns the oscilloscope's precision analysis setting on or off. The precision analysis setting is OFF after a *RST command.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns precision analysis on or off. |
Specifies the length of the precision analysis record when precision measurements and math functions mode is enabled. The setting can be between 100k and 1M points.
| Name | Type | Values | Description |
|---|---|---|---|
| length | integer | 100k - 1M | Precision analysis record length in points. |
Places the instrument in a known default state, equivalent to pressing the front-panel Default Setup key. Some user settings remain unchanged; use *RST to restore factory defaults.
Disables or enables the 50 ohm impedance setting for all analog channels. Turning it on has no front-panel visual indication other than a disabled 50 Ω channel input impedance selection.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 1 | ON | 0 | OFF | Turns protection lock on or off. |
Enables or disables remote command logging and can optionally specify 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 | Selects whether the log file is created or appended to. |
Specifies whether remote commands are logged to a text file on a connected USB storage device, to the screen, or both. If the destination is changed while remote command logging is running, logging is turned off.
| Name | Type | Values | Description |
|---|---|---|---|
| dest | enum | FILE | SCReen | BOTH | Selects the remote command logging destination. |
Enables or disables the screen display of logged remote commands and their return values, if applicable.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | 0 | OFF | 1 | ON | Turns the display of logged remote commands on or off. |
Specifies the remote command log file name. Because log files are ASCII text files, the ".txt" extension is automatically added to the specified name.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Quoted ASCII string giving the remote command log file name. |
Enables or disables remote command logging. The query returns the remote command logging state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Enables or disables remote command logging. |
Specifies whether the screen display background for remote command logging is transparent or solid.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the transparent screen display background setting. |
Specifies the remote command logging write mode. The query returns the current remote command logging write mode.
| Name | Type | Values | Description |
|---|---|---|---|
| write_mode | enum | CREate | APPend | Selects the remote command logging write mode. |
Sets the oscilloscope as defined by the setup (learn) string sent from the controller. The setup string does not change the interface mode or interface address.
| Name | Type | Values | Description |
|---|---|---|---|
| setup_data | block | - | Binary block data in IEEE 488.2 # format. |
myScope.WriteIEEEBlock ":SYSTEM:SETUP ", varSetupString
Sets the system time using a 24-hour format. Commas separate hours, minutes, and seconds, and validity checking ensures 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; MAIN is the default after *RST.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | MAIN | WINDow | XY | ROLL | Selects the 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 in seconds. The range is 10 times the current time-per-division setting.
| Name | Type | Values | Description |
|---|---|---|---|
| range_value | real | s | Time for 10 divisions in seconds, in NR3 format. |
myScope.WriteString ":TIM:RANG 2e-3" ' Set the time range to 0.002 seconds.
Enables or disables the 10 MHz REF BNC on the rear panel of the oscilloscope. ON enables the BNC and sets the reference signal mode to IN; OFF disables the BNC.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 1 | ON | 0 | OFF | Enables or disables the 10 MHz REF BNC. |
Sets the time reference for the main window display. The reference can be set to the left, center, right, or a custom location defined by :TIMebase:REFerence:LOCation.
| 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 when :TIMebase:REFerence is set to CUSTom. The location is specified as a percentage of the graticule width, from 0.0 at the left edge to 1.0 at the right edge.
| Name | Type | Values | Description |
|---|---|---|---|
| loc | real | 0.0 - 1.0 | Time reference location as a fraction of graticule width. |
Sets the horizontal scale or units per division for the main window. The query returns the current horizontal scale setting in seconds per division for the main window.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_value | real | s | Time per division in seconds, in NR3 format. |
Specifies whether the time base control's vernier (fine horizontal adjustment) setting is ON (1) or OFF (0).
| Name | Type | Values | Description |
|---|---|---|---|
| vernier value | enum | 1 | ON | 0 | OFF | Sets the vernier setting. |
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 value is given in NR3 format, and the maximum is one half of :TIMebase:RANGe.
| Name | Type | Values | Description |
|---|---|---|---|
| range value | real | one half of :TIMebase:RANGe | Range value in seconds for the zoomed window timebase. |
Sets the zoomed (delayed) window horizontal scale in seconds per division. The maximum value is one half of the :TIMebase:SCALe value.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_value | real | s | Scale value in seconds for the zoomed window, specified in NR3 format. |
:TIMebase:WINDow:SCALe <scale_value> :TIMebase:WINDow:SCALe?
Sets the main time base delay, the time between the trigger event and the delay reference point on the screen. This command is obsolete and provided for backward compatibility; use :TIMebase:POSition instead.
| Name | Type | Values | Description |
|---|---|---|---|
| delay_value | real | s | Time in seconds from trigger to the delay reference point on the screen. |
myScope.WriteString ":TIMEBASE:DELAY 0.0"
Causes an acquisition to be captured even though the trigger condition has not been met. This command 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. Holdoff prevents triggering again until a specified time has elapsed since the last trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| holdoff_time | real | 40 ns - 10 s | Holdoff time value in seconds, formatted as NR3. |
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. |
Disables or enables the Jitter-Free Trigger option. It is used to minimize trigger jitter at the trigger point in certain trigger modes and timebase ranges.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Selects whether Jitter-Free Trigger is disabled or enabled. |
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; with dual trigger levels, 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 | - | High trigger level voltage, specified as 0.75 x full-scale voltage from center screen in NR3 format for internal triggers. |
| source | discrete | CHANnel<n> | Trigger source channel. |
Sets the low trigger voltage level for the specified source. High and low trigger levels are used with runt triggers and rise/fall time (transition) triggers.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | Low trigger voltage level in NR3 format; for internal triggers it is 0.75 x full-scale voltage from center screen. |
| source | channel_list | - | Trigger source, specified as CHANnel<n> where n is 1 to the number of analog channels. |
Selects the trigger mode (trigger type). The query returns the current trigger mode, or "NONE" if :TIMebase:MODE is ROLL or XY.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | EDGE | GLITch | PATTern | TV | DELay | EBURst | OR | RUNT | SHOLd | TRANsition | SBUS1 | SBUS2 | Sets the trigger mode. |
myScope.WriteString ":TRIGger:MODE EDGE"
Turns the trigger noise reject filter off and on. The command is not valid in TV trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | 0 | OFF | 1 | ON | Sets the noise reject filter mode. |
Selects the trigger sweep mode. AUTO displays a baseline in the absence of a signal, while NORMal stops sweeping when no trigger is present.
| Name | Type | Values | Description |
|---|---|---|---|
| sweep | enum | AUTO | NORMal | Trigger sweep mode to select. |
Sets the 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 to use. |
Selects the input used for the arming edge in the Edge Then Edge trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input source used for the arming edge. |
Sets the delay time between the arming edge and the trigger edge in the Edge Then Edge trigger. The time is specified in seconds and must be from 4 ns to 10 s.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 4 ns - 10 s | Time in seconds in NR3 format. |
Sets the Nth edge of the trigger source to trigger on. The query returns the current Nth trigger edge setting.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Nth trigger edge to use. |
Specifies whether the trigger edge in the Edge Then Edge trigger is rising (POSitive) or falling (NEGative). The query returns the current trigger edge slope setting.
| 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 source can be an analog channel or a digital channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Specifies the trigger edge source channel. |
Sets the Nth edge of the burst edge counter used in the trigger stage to determine which edge in a burst will generate a trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Nth edge count in NR1 integer format. |
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. |
Specifies whether the rising or falling edge of the Nth edge in a burst will generate a trigger. The query returns the current burst-slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects whether the burst trigger uses the falling edge (NEGative) or rising edge (POSitive). |
Selects the input that produces the Nth edge burst trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Input source for the edge burst trigger. |
Sets the input coupling for the selected trigger sources. The coupling can be AC, DC, or LFReject; the query returns the current coupling selection.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | AC | DC | LFReject | Input coupling selection for the trigger path. |
Sets the trigger level voltage for the active trigger source. If an optional source is specified and is not the active source, the active source is not changed and its level is not affected.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | V | Trigger level voltage, in NR3 format: 0.75 x full-scale voltage from center screen for internal triggers, ±(external range setting) for external triggers, or ±8 V for digital channels (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. Only one of these filters can be on at a time, and the setting is coupled with :TRIGger[:EDGE]:COUPling.
| Name | Type | Values | Description |
|---|---|---|---|
| reject | enum | OFF | LFReject | HFReject | Selects the reject filter state or filter mode. |
Specifies the slope of the edge used for triggering. The command is not valid in TV trigger mode; use :TRIGger:TV:POLarity instead.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | EITHer | ALTernate | Sets the trigger edge slope. |
:TRIGGER:EDGE:SLOPE POSITIVE
Selects the input source that produces the edge trigger. For DSO models the source can be an analog channel, external trigger, line, waveform generator, or WMOD; for MSO models it can also be a digital channel.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | EXTernal | LINE | WGEN | WGEN1 | WGEN2 | WMOD | DIGital<d> | Input source used for triggering. |
:TRIGger[:EDGE]:SOURce CHANnel1
Sets the minimum pulse width duration for the selected :TRIGger:GLITch:SOURce. The query returns that minimum pulse width duration time.
| Name | Type | Values | Description |
|---|---|---|---|
| greater_than_time | real | - | Minimum pulse width duration in floating-point NR3 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; if all channels are off, it returns "NONE."
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | V | Trigger level voltage. |
| sourceopt | enum | CHANnel<n> | EXTernal | DIGital<d> | Source channel for the trigger level, 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 | Sets the glitch pulse width trigger polarity. |
Sets the mode of operation of the glitch pulse width trigger. The oscilloscope can trigger on a pulse width that is greater than a time value, less than a time value, or within a range of time values.
| Name | Type | Values | Description |
|---|---|---|---|
| operator | enum | GREaterthan | LESSthan | RANGe | Selects whether the trigger condition is greater than, less than, or within a range of time values. |
Sets the pulse width duration for the selected :TRIGger:GLITch:SOURce. The two time values may be entered in any order; the smaller value becomes <greater_than_time> and the larger becomes <less_than_time>.
| Name | Type | Values | Description |
|---|---|---|---|
| less_than_time | real | 15 ns - 10 seconds | Upper pulse-width limit. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower pulse-width limit. |
Selects the channel that produces the pulse width trigger. The query returns the current pulse width source; if all channels are off, it returns "NONE".
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | DIGital<d> | CHANnel<n> | Channel source for the pulse width trigger. |
Specifies which edges to include in the OR'ed edge trigger by sending a bit string. Each bit corresponds to a channel, with characters R, F, E, or X indicating rising edge, falling edge, either edge, or don't care.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Bit string where each character selects the edge condition for the corresponding channel. |
:TRIGger:OR <string> :TRIGger:OR?
Sets the channel values used for the pattern trigger. The pattern string may be ASCII or HEX format, and optional edge source and edge can be sent with the HEX form; if used, they take precedence.
| Name | Type | Values | Description |
|---|---|---|---|
| pattern | string | - | Pattern string, optionally followed by edge source and edge. |
Sets the entry and query number base used by the :TRIGger:PATTern command. The default base is ASCii.
| Name | Type | Values | Description |
|---|---|---|---|
| base | enum | ASCii | HEX | Number base used for pattern trigger patterns. |
Sets the minimum duration for the defined pattern when :TRIGger:PATTern:QUALifier is set to GREaterthan, and also sets the timeout value when the qualifier is set to TIMeout. The query returns the minimum duration time for the defined pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| greater_than_time | real | s | Minimum trigger duration in seconds, entered in NR3 format. |
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 seconds, entered in NR3 format. |
| suffixopt | enum | s | ms | us | ns | ps | Optional time suffix. |
Qualifies when the pattern trigger occurs. The selected qualifier determines whether the trigger happens when the pattern is entered, exits after being present for a duration, or is present within or outside a time range.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | ENTered | GREaterthan | LESSthan | INRange | OUTRange | TIMeout | Trigger duration qualifier. |
Sets the duration for the defined pattern when :TRIGger:PATTern:QUALifier is set to INRange or OUTRange. 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 duration limit for the defined pattern. |
| greater_than_time | real | 10 ns - 9.99 seconds | Lower duration limit for the defined pattern. |
:TRIGger:PATTern:RANGe <less_than_time>[<suffix>], <greater_than_time>[<suffix>] :TRIGger:PATTern:RANGe?
Sets the polarity for the runt trigger. The query returns the current runt trigger polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | EITHer | Selects positive, negative, or either polarity for runt pulses. |
Selects the qualifier used for specifying runt pulse widths. GREaterthan triggers on runt pulses wider than :TRIGger:RUNT:TIME, LESSthan triggers on runt pulses narrower than :TRIGger:RUNT:TIME, and NONE triggers on runt pulses of any width.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | NONE | Selects the runt trigger qualifier. |
Selects the channel used to produce the runt trigger. The query returns the current runt trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Channel used to produce the trigger. |
Sets the runt pulse qualifier time used when triggering on runt pulses whose width is greater than or less than a specified value. The time may be entered with an optional unit suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | s | Runt pulse qualifier time in NR3 floating-point format. |
Specifies whether the rising edge or the falling edge of the clock signal is used.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Selects the trigger slope. |
Selects the input channel probing the clock signal. The query returns the currently set clock signal source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | channel_list | - | Clock signal source channel, specified as an analog channel or a digital channel. |
Selects the input channel probing the data signal.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | DIGital<d> | Selects the data signal source. |
Sets the hold time for the trigger hold-time function. The query returns the currently specified hold time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Hold time value in NR3 floating-point format. |
| suffixopt | enum | s | ms | us | ns | ps | Unit suffix for the time value. |
Sets the setup time. The query returns the currently specified setup time.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | - | Setup time in floating-point NR3 format; an optional suffix may specify s, ms, us, ns, or ps. |
Specifies whether rise/fall times greater than or less than a certain time value are used for trigger qualification. The time value is set with :TRIGger:TRANsition:TIME.
| Name | Type | Values | Description |
|---|---|---|---|
| qualifier | enum | GREaterthan | LESSthan | Selects whether the trigger looks for times greater than or less than the specified value. |
Sets the trigger transition slope to positive rising edge or negative falling edge. The query returns the current rise/fall time trigger slope setting.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | NEGative | POSitive | Specifies the trigger slope direction. |
Selects the channel used to produce the trigger. The query returns the current transition trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | string | - | Channel identifier to use as the transition trigger source. |
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. |
Sets the TV trigger to trigger on a specific video line. The allowable line number depends on the TV standard and mode.
| Name | Type | Values | Description |
|---|---|---|---|
| line_number | integer | 1 - 1125 | Line number to trigger on, expressed as an integer in NR1 format. |
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 to select. |
Sets the polarity for the TV trigger. The query returns the TV trigger polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Polarity setting for the TV trigger. |
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 video standard used for TV triggering. With an extended Video triggering license, additional standards are supported beyond the basic NTSC/PAL/PAL-M/SECAM set.
| Name | Type | Values | Description |
|---|---|---|---|
| standard | enum | GENeric | NTSC | PALM | PAL | SECam | P480L60HZ | P480 | P567L50HZ | P720L50HZ | P720 | P1080L24HZ | P1080 | P1080L25HZ | P1080L30HZ | P1080L50HZ | P1080L60HZ | I1080L50HZ | I1080 | I1080L60HZ | TV trigger standard to select. |
Sets the Generic video trigger's Nth edge to trigger on after synchronizing with the vertical sync. The query returns the edge count setting.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | - | Edge number in NR1 format. |
Enables or disables the horizontal sync control in the Generic video trigger. It is used with HTIMe adjustments to help ENUMber count only lines in interleaved or progressive video cases.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | OFF | 1 | ON | Sets the horizontal sync control state. |
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 in NR3 format. |
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 | enum | CHANnel<n> | Analog source channel. |
Enables or disables the zone qualified trigger feature. When enabled, the zone(s) are actively used to qualify the trigger; the query returns whether this feature is enabled or disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| on_off | enum | 0 | OFF | 1 | ON | Turns the zone qualified trigger feature off or on. |
Sets the zone qualifying condition for Zone 1 or Zone 2. The condition can be set to either intersect or not intersect.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INTersect | NOTintersect | Selects whether the zone must intersect or must not intersect. |
Sets or queries the size and location of Zone 1 or Zone 2. The command uses the zone number <n> in NR1 format.
| 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. A zone may return INValid if the two zones overlap with opposing qualifying conditions, OSCReen if it is off-screen, or VALid if it is neither invalid nor off-screen.
Sets the state for Zone 1 or Zone 2. When a zone is on and Zone Trigger is enabled, that zone is used to qualify the trigger; if both zones are off, Zone Trigger is automatically turned off.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Zone number (1 or 2). |
| on_off | enum | 0 | OFF | 1 | ON | Turns the selected zone state off or on. |
Sets the trigger threshold for a pod of 8 digital channels. The threshold may be set to a predefined type or to a user-defined voltage; for predefined types, the voltage argument is not required.
| Name | Type | Values | Description |
|---|---|---|---|
| channel group | enum | POD1 | POD2 | Selects which pod of digital channels the threshold applies to. |
| threshold type | enum | CMOS | ECL | TTL | USERdef | Selects a predefined threshold type or USER-defined threshold. |
| valueopt | real | -8.0V - +8.0V | User-defined threshold voltage. |
Selects the TV trigger mode and field. It is an obsolete command retained for compatibility; use :TRIGger:TV:MODE instead.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERtical | TV trigger mode to select. |
:TRIGger:TV:TVMode <mode> :TRIGger:TV:TVMode?
Sets the output sequence of the WORD data. It affects the transmitting sequence only when :WAVeform:FORMat WORD is selected; the default is MSBFirst.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | LSBFirst | MSBFirst | Selects whether the most significant byte or least significant byte is transmitted first. |
:WAVeform:BYTeorder?
Returns the count used to acquire the current waveform. For all acquisition types except average, this value is 1.
Returns sampled waveform data as a binary block in IEEE 488.2 arbitrary block data format. The data format and number of points returned are controlled by related :WAVeform commands.
myScope.WriteString ":WAV:DATA?"
Sets the data transmission mode for waveform data points. When the waveform source is SBUS1 or SBUS2, only ASCii is allowed; when the source is BUS1 or BUS2, only ASCii and WORD are allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | WORD | BYTE | ASCii | Selects the waveform data format. |
Sets the desired number of analog channel waveform points to be transferred with the :WAVeform:DATA? query. The command accepts either an integer point count or a deprecated points mode keyword.
| Name | Type | Values | Description |
|---|---|---|---|
| wfm_points | integer | 100 - 10000000 | Integer number of waveform points to transfer. |
| wfm_points | enum | NORMal | MAXimum | RAW | Deprecated points mode option. |
myScope.WriteString ":WAVeform:POINTS 1000"
Sets the waveform data record transferred by the :WAVeform:DATA? query. The selected record can be normal, maximum, or raw, with availability depending on source and :SYSTem:PRECision state.
| Name | Type | Values | Description |
|---|---|---|---|
| points_mode | enum | NORMal | MAXimum | RAW | Selects which data record is used for waveform data transfer. |
Queries the preamble information for the selected waveform source. The preamble block contains vertical and horizontal scaling information for the corresponding channel.
myScope.WriteString ":WAVEFORM:PREAMBLE?" ' Query for the 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 | Enables or disables the all-segments waveform data setting. |
Returns the number of memory segments in the acquired data. It 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 the X (time) information for all waveform segments at once. The <xlist_type> option selects whether the relative X-origin, time tag, or absolute X-origin is returned for each segment.
| Name | Type | Values | Description |
|---|---|---|---|
| xlist_type | enum | RELXorigin | ABSXorigin | TTAG | Specifies the type of X information returned for each segment. |
Selects the waveform source used by the :WAVeform commands. The source can be an analog channel, function, reference waveform, serial decode bus, and on MSO models a digital pod or bus.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | SBUS{1 | 2} | POD{1 | 2} | BUS{1 | 2} | Waveform source to use. The allowed choices depend on whether the instrument is a DSO or MSO model. |
:WAVeform:SOURce CHAN1 myScope.WriteString ":WAVEFORM:SOURCE CHAN1"
Selects the waveform subsource used when :WAVeform:SOURce is SBUS<n> (serial decode). The available choices depend on the serial decode mode; for UART, SPI, and SENT the aliases TX/RX, MISO/MOSI, and SLOW/FAST map to SUB1/SUB0 respectively.
| Name | Type | Values | Description |
|---|---|---|---|
| subsource | enum | SUB0 | RX | MOSI | FAST | SUB1 | TX | MISO | SLOW | Chooses which 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 data values are sent as unsigned or signed integers and has no effect if the data format is ASCII.
| Name | Type | Values | Description |
|---|---|---|---|
| unsigned | enum | 0 | OFF | 1 | ON | Selects whether unsigned mode is disabled or enabled. |
Sets the view setting associated with the currently selected waveform. Currently, the only legal value is MAIN.
| Name | Type | Values | Description |
|---|---|---|---|
| view | enum | MAIN | View setting to apply to the selected waveform. |
Returns the x-increment value for the currently specified source. This value is the time difference between consecutive data points in seconds.
Returns the x-origin value for the currently specified source. In this product, XORigin is the X-axis value of the first data point (XREFerence = 0).
Returns the x-reference value for the currently specified source. In this product, the x-reference point is always the first displayed point, so XREFerence is always 0.
Returns the y-increment value in volts for the currently specified source. This value is the voltage difference between consecutive data values; for digital waveforms, the y-increment is always "1".
Returns the y-origin value for the currently specified source. For this product, it is the Y-axis value of the center of the screen.
Returns the y-reference value for the currently specified source. This value specifies the data point value where the y-origin occurs, and 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 to use for binary transfers. |
Downloads an arbitrary waveform in floating-point values format. The data may be sent as an IEEE 488.2 binary block or as comma-separated values.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output index in NR1 format. |
| binary | real | -1.0 - +1.0 | Floating-point waveform data in IEEE 488.2 binary block format. |
| value | real | -1.0 - +1.0 | Floating-point waveform sample value in comma-separated format. |
: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 number in NR1 format. |
| binary | integer | -512 - +511 | 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 for the arbitrary waveform on the selected WaveGen output. When ON, points are connected linearly; when OFF, 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 arbitrary waveform memory.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | WMEMory<r> | FUNCtion<m> | MATH<m> | Source waveform to store into arbitrary waveform memory. |
Sets the waveform generator frequency for channel <w>. For all waveforms except Noise and DC, the frequency can also be specified 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 Hz 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 on the selected WaveGen output. 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 ramp waveform symmetry for the selected WaveGen output. Symmetry is the percentage of each cycle that the ramp waveform is rising.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | Symmetry percentage. |
Specifies the square wave duty cycle for :WGEN<w> function square waveforms. Duty cycle is the percentage of the period that the waveform is high.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 20% - 80% | Duty cycle percentage. |
Specifies the amount of amplitude modulation as a percentage. The setting controls what portion of the amplitude range is used by the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | integer | 0% - 100% | AM depth percentage. |
Sets the frequency of the modulating signal. The query returns the frequency of the modulating signal.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency. |
Sets the FM frequency deviation for waveform generator channel <w>. The deviation cannot be greater than the original carrier frequency, and the carrier frequency plus deviation must not exceed the selected waveform generator function maximum plus 100 kHz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Frequency deviation. |
Specifies the frequency of the FM modulating signal. The query returns the modulating waveform frequency in Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Modulating waveform frequency. |
Specifies the FSK hop frequency. The output frequency shifts between the original carrier frequency and this hop frequency.
| Name | Type | Values | Description |
|---|---|---|---|
| frequency | real | Hz | Hop frequency in Hz. |
Specifies the FSK modulation rate, i.e. the rate at which the output frequency shifts. The rate is given in Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| rate | real | Hz | FSK modulation rate. |
Specifies the shape of the modulating signal for AM and FM modulation. If RAMP is selected, the ramp rise time per cycle 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 modulation symmetry percentage, which controls the amount of time per cycle that the ramp waveform is rising. The query returns the current ramp symmetry percentage setting.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0% - 100% | Symmetry percentage. |
Adds noise to the currently selected signal. The percentage range depends on the current amplitude because the combined original signal and injected noise are limited by the regular amplitude limit.
| Name | Type | Values | Description |
|---|---|---|---|
| percent | real | 0 - 100 | Percent of noise to add to the signal. |
Enables or disables modulated waveform generator output. Modulation can be enabled for all waveform generator function types except pulse, DC, and noise.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | OFF | 0 | ON | 1 | Selects whether modulation is enabled or disabled. |
Selects the modulation type for the waveform generator. The available types are AM, FM, and FSK.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | AM | FM | FSK | Selects the modulation type. |
Specifies whether the waveform generator signal output is ON or OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output index in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Turns the waveform generator output on or off. |
Selects the expected output load impedance for the waveform generator output. The setting is used so the instrument can display correct amplitude and offset levels for the expected load.
| 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 (single-shot). The query returns the current output mode setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | SINGle | Sets the waveform output mode. |
Specifies whether the waveform generator output is inverted. The query returns the specified output polarity.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output index in NR1 format. |
| 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 waveforms other than 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 | Period of the waveform in seconds, in NR3 format. |
Restores the waveform generator factory default settings for the selected output. The defaults are 1 kHz sine wave, 500 mVpp, and 0 V offset.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output number in NR1 format. |
Enables or disables waveform-generator tracking for output <w>. When tracking is enabled, frequency, amplitude, offset, and duty-cycle adjustments on this output are tracked by the other waveform-generator output, subject to waveform-group compatibility.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - # WaveGen outputs | WaveGen output index in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Turns tracking on or off. |
Sets whether amplitude tracking is enabled for a waveform generator output. When tracking is on, amplitude and offset adjustments on this output are tracked by the other waveform generator output, and tracked settings on the other output 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 waveform-generator frequency tracking on or off for the selected output. When enabled, frequency adjustments on this output are tracked by the other waveform generator output, subject to waveform-group compatibility.
| Name | Type | Values | Description |
|---|---|---|---|
| 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 current frequency-tracked waveform phase relationship setting.
| Name | Type | Values | Description |
|---|---|---|---|
| phase | real | -360 - +360 | Phase relationship setting in NR1 format. |
Specifies the waveform amplitude for the selected WaveGen output. For all waveforms except DC, use this command to set amplitude; offset or DC level is set separately.
| Name | Type | Values | Description |
|---|---|---|---|
| amplitude | real | V | Amplitude in volts. |
Sets the waveform high-level voltage for all waveforms except DC on the selected WaveGen output. The query returns the currently specified waveform 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. |
Sets the waveform low-level voltage for :WGEN<w> outputs except DC. The high-level voltage is set with :WGEN<w>:VOLTage:HIGH; high and low levels can also be specified indirectly with :WGEN<w>:VOLTage and :WGEN<w>:VOLTage:OFFSet.
| Name | Type | Values | Description |
|---|---|---|---|
| w | integer | 1 - (# WaveGen outputs) | WaveGen output number in NR1 format. |
| low | real | V | Low-level voltage in NR3 format. |
Specifies the waveform's offset voltage or DC level for the selected WaveGen output. The amplitude is set with :WGEN<w>:VOLTage, and the offset is limited to ±500 mV when the amplitude is below 40 mV.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | V | Offset voltage for the waveform or DC level. |
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; turning one ON automatically turns the other OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Reference waveform location number in NR1 format. |
| on_off | enum | 1 | ON | 0 | OFF | Display state to set for the selected reference waveform. |
Sets the label for a reference waveform. The label is stored in non-volatile memory and labels longer than 10 characters are truncated to 10 characters; lowercase characters are converted to uppercase.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Quoted ASCII label string to assign to the reference waveform. |
Copies the specified analog channel or math function waveform to the selected reference waveform location. Math functions whose x-axis is not frequency can also be saved as reference waveforms.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel<n> | FUNCtion<m> | MATH<m> | Source waveform to save. |
Sets the skew factor for the specified reference waveform. The query returns the current skew setting for the selected reference waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - # ref waveforms | Reference waveform number to modify. |
| skew | real | s | Skew time in seconds. |
Sets the value represented at center screen for the selected reference waveform. The legal range depends on the :WMEMory<r>:YRANge or :WMEMory<r>:YSCale setting and on probe attenuation; out-of-range values are adjusted to the nearest legal value.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | V | Vertical offset value in NR3 format. |
| suffixopt | enum | V | mV | Optional unit suffix. |
Defines the full-scale vertical axis of the selected reference waveform. Legal values for the range are copied from the original source waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| r | integer | 1 - (# ref waveforms) | Reference waveform number in NR1 format. |
| range | real | - | Vertical full-scale range value in NR3 format. |
Sets the vertical scale, or units per division, 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 to select. |
| scale | real | - | Vertical units per division in NR3 format. |
Clears the cumulative edge variables for the next activity query. This obsolete command is provided for compatibility with previous oscilloscopes; use :ACTivity instead.
Sets the source text to a quoted ASCII string and adds the name to the label list. This obsolete command is provided for compatibility with previous oscilloscopes.
| Name | Type | Values | Description |
|---|---|---|---|
| source_text | enum | CHANnel1 | CHANnel2 | DIGital<d> | Selects the source channel for the label. |
| string | string | - | Quoted ASCII label text to assign. |
Sets the threshold for a group of channels. The threshold can be set to a predefined value or to a user-defined voltage; for predefined values, the voltage parameter is ignored.
| Name | Type | Values | Description |
|---|---|---|---|
| channel group | enum | POD1 | POD2 | Channel group to configure. |
| threshold type | enum | CMOS | ECL | TTL | USERdef | Threshold preset or user-defined mode. |
| valueopt | real | -6.0V - 6.0V | User-defined threshold voltage in NR3 format, used when threshold type is USERdef. |
Sets the skew between channels 1 and 2. This obsolete command is provided for compatibility with previous oscilloscopes and is only valid for two-channel models.
| Name | Type | Values | Description |
|---|---|---|---|
| skew value | real | -100 ns - +100 ns | Skew time in NR3 format. |
Erases the screen. This command is obsolete and 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 | Selects the g(t) math operation. |
Selects the first input channel for the g(t) source used as the input to transform or filter functions, if available.
| Name | Type | Values | Description |
|---|---|---|---|
| value | discrete | - | First input channel for the g(t) source. |
Selects the second input channel for the g(t) source used as the input to transform or filter functions, if available.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | Second input channel selection. |
Selects the source for function operations when FFT, DIFF, or INT is selected. This obsolete command is provided for compatibility with previous oscilloscopes; use :FUNCtion:SOURce1 instead.
| Name | Type | Values | Description |
|---|---|---|---|
| value | enum | CHANnel<n> | ADD | SUBTract | MULTiply | Source used for function operations. |
:FUNCtion:SOURce <value>
Turns the selected function on or off. This obsolete 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. |
:FUNCtion:VIEW <view> :FUNCtion:VIEW?