Returns the maximum real-time sample rate, which varies from model to model. Query only.
ACQUIRE:MAXSAMPLERATE? might return 1.0000E+9 indicating the maximum real-time sample rate is 1.0 GS/s.
SCPI COMMAND REFERENCE
The Tektronix TBS1072C is Tektronix's oscilloscope in the TBS1000C family. Its SCPI remote-control interface exposes 443 commands across 51 subsystems - 202 settable and 241 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.
443
Commands
202
Settable
241
Queries
51
Subsystems
SCPI
Verified
2026-07-16
Returns the maximum real-time sample rate, which varies from model to model. Query only.
ACQUIRE:MAXSAMPLERATE? might return 1.0000E+9 indicating the maximum real-time sample rate is 1.0 GS/s.
Sets the acquisition mode of the instrument for all live waveforms. Waveforms are the displayed data point values taken from acquisition intervals.
Returns the current acquisition settings. Query only.
ACQuire? might return the following string for the current acquisition: ACQUIRE:STOPAFTER RUNSTOP;STATE 1; MODE SAMPLE;NUMAVG 16
Indicates the number of acquisitions that have taken place since instrument acquisition started. The count continues increasing while acquisitions are running and resets to 0 only if the horizontal scale is changed while acquisitions are running.
Sets or queries the number of waveform acquisitions that make up an averaged waveform. Average mode must be enabled with ACQuire:MODe.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 512 | Number of waveform acquisitions to average, in powers of two. |
ACQuire:NUMAVg 16 specifies that 16 waveform averages are performed before exponential averaging starts. ACQuire:NUMAVg? might return ACQUIRE:NUMAVG 64 indicating that there are 64 acquisitions specified for averaging.
Starts or stops acquisitions. Setting State to ON or RUN starts a new acquisition; issuing RUN while a single sequence is completing restarts the acquisition sequence and discards accumulated data.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | RUN | Acquisition state to set. |
Sets or returns whether the instrument continually acquires data or performs a single-sequence acquisition.
ACQuire:STOPAfter `RUNSTOP sets the instrument to continually acquire data. ACQuire:STOPAfter? might return: ACQUIRE:STOPAFTER SEQUENCE indicating that the next acquisition the instrument makes will be of the single-sequence type.
Sets or queries the state of alias functionality. Alias commands define new commands as a sequence of standard commands; alias expansion can be turned off or on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | <NR1> | Turns alias expansion off, on, or enables alias mode with a numeric value. |
ALIAS ON turns the alias feature on. ALIAS? might return :ALIAS 1 indicating that the alias feature is on.
Returns a list of the currently defined alias labels, separated by commas. If no aliases are defined, the query returns the string "".
ALIAS:CATALOG? might return the string :ALIAS:CATALOG "SETUP1","TESTMENU1","DEFAULT" showing that there are three aliases named SETUP1, TESTMENU1, and DEFAULT.
Assigns a sequence of program messages to an alias label. The query form returns the definition of a selected alias.
| Name | Type | Values | Description |
|---|---|---|---|
| alias label | string | - | Label assigned to the alias. |
| sequence | string | - | Complete sequence of program messages to substitute for the alias. |
ALIAS:DEFINE "ST1",":RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON" ALIAS:DEFINE? "ST1"
Returns the definition of a selected alias. The alias label is the first string argument and the stored program message sequence is returned in quoted/definite-block form.
| Name | Type | Values | Description |
|---|---|---|---|
| alias label | string | - | Alias label to define. |
ALIAS:DEFINE? "ST1" returns :ALIAS:DEFINE "ST1",#246 :RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON.
Removes a specified alias. It is identical to `ALIas:DELEte:NAMe`; an error is generated if the named alias does not exist.
| Name | Type | Values | Description |
|---|---|---|---|
| QString | string | - | Alias name to delete. |
Deletes all existing aliases. No query form.
ALIAS:DELETE:ALL deletes all existing aliases.
Removes a specified alias. This command is identical to ALIas:DELEte. No query form.
| Name | Type | Values | Description |
|---|---|---|---|
| QString | string | - | Name of the alias to remove; it must already exist. |
ALIAS:DELETE:NAME "STARTUP" deletes the alias named STARTUP.
Turns aliases on or off. This command is identical to the ALIas command.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | Turns alias expansion off or on. |
ALIAS:STATE OFF turns the command alias feature off. ALIAS[:STATE]? returns 0 when the alias feature is off.
Returns all events and their messages from the Event Queue, and removes the returned events from the queue. The messages are separated by commas.
Returns the first entry in the event log / alert queue. The example shows a query response of a code and message string.
> ALLEV ?
Queries the list of active alarm/event messages. The example shows it returning a measurement error string.
ALLEV? ALLEV 2202,"Measurement error, No period found; "
Causes the instrument to adjust its vertical, horizontal, and trigger controls to display a stable waveform. This command is equivalent to pushing the front-panel AUTOSET button.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | EXECute | UNDo | Selects whether Autoset runs on the selected waveform or restores the oscilloscope settings to those prior to Autoset. |
Allows educators to disable or enable the Autorange and Autoset functions. The function can be manually set from the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the autoset feature. |
Enables or disables the Autorange and Autoset functions. The feature can be manually set from the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the autoset feature. |
AUTOSET:ENABLE OFF AUTOSET:ENABLE?
Performs an internal self-calibration and returns its status. It is a query that also performs the calibration action and may take several minutes to complete.
*CAL? performs a self-calibration and might return 0 to indicate that it completed successfully.
Clears the instrument status data structures: the Event Queue, the Standard Event Status Register (SESR), and the Status Byte Register except the MAV bit. If *CLS immediately follows an <EOI>, the Output Queue and MAV bit are also cleared.
*CLS clears the instrument status data structures.
Returns the instrument identification code in IEEE 488.2 notation. Query only.
Query only. This command is identical to the query.
Sets the power-on status clear flag that controls automatic power-on handling of the DESER, SRER, and ESER registers. Command only; no query form is documented on this page.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | NR1> | Sets whether the power-on status clear flag is false or true, or accepts an NR1 value. |
*PSC 0
Restores the instrument state from a saved setup stored in memory. It is equivalent to RECAll:SETUp and has no query form.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 1 - 10 | Specifies the setup storage location. |
*RCL 3 restores the instrument from a copy of the settings stored in memory location 3.
Resets the instrument to a known set of settings without purging stored settings. It executes a subset of the FACtory command and does not change several stored status, calibration, alias, waveform, password, or queue-related items.
*RST resets the instrument settings to factory defaults.
Saves the state of the instrument into a specified nonvolatile memory location. This is equivalent to selecting the Save Setup option in the Save/Recall Setup menu; command only, no query form.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 1 - 10 | Memory location to save the current instrument state. |
*SAV 2 saves the current instrument settings in memory location 2.
Reads the Status Byte Register (SBR). When obtained with *STB?, bit 6 is the MSS bit, which summarizes the ESB and MAV bits in the SBR; reading the SBR does not clear its bits.
Sets the Event Status Enable Register (ESER), which controls which types of events are summarized by the Event Status Bit (ESB) in the SBR. Use *ESE? to read the register.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Bits to set in the Event Status Enable Register. |
Reads the Event Status Enable Register (ESER). The register controls which types of events are summarized by the Event Status Bit (ESB) in the SBR.
Controls the Enable Register contents at power-on. *PSC 1 initializes the Enable Registers to preset values; *PSC 0 preserves their values in nonvolatile memory through a power cycle.
| Name | Type | Values | Description |
|---|---|---|---|
| state | integer | 0 - 1 | Sets whether the Enable Registers are preset at power-on or retain their values through power cycles. |
Sets the Service Request Enable Register (SRER), which controls which Status Byte Register bits generate a service request and are summarized by the Master Status Summary (MSS) bit.
| Name | Type | Values | Description |
|---|---|---|---|
| enable_bits | integer | 0 - 255 | Bit mask written to the SRER. |
Reads the Service Request Enable Register (SRER). The register controls which bits in the SBR generate a Service Request and are summarized by the MSS bit.
Forces completion of previous commands that generate an OPC message. No commands after *WAI are processed before the OPC message(s) are generated.
Sets the OPC bit in the Standard Event Status Register (SESR) when an operation is complete, allowing synchronization via serial poll or service request handling.
Returns the Standard Event Status Register value and clears the register. In the example, `*ESR?` returns `128` after checking for messages, and later `16` after a measurement error check.
*ESR?
Indicates when all pending commands have been executed. It is commonly used to wait for an operation to complete before continuing.
*OPC?
Starts a signal path compensation. It is a command-only function with no query form.
CALibrate:INTERNAL starts a signal path compensation cycle.
Starts the internal signal path calibration (SPC) of the instrument.
CALIBRATE:INTERNAL:START initiates the internal signal path compensation of the instrument.
Returns the current status of the instrument internal signal path compensation for the last SPC operation. Query only.
CALibrate:INTERNal:STATus? might return :CALIBRATE:INTERNAL:STATUS INIT indicating that the current status of the internal signal path compensation is that it has not been run.
Returns the status of the SPC operation without initiating SPC. Query only.
Returns the status of internal and factory calibrations without performing any calibration operations. It is intended for GO/NoGO testing of calibration readiness and does not include attached probes.
CALibrate:RESults? might return :CALibrate:RESults INIT indicating the instrument has not be calibrated.
Sets or queries the measure current status for the specified channel. The value of <x> can vary from 1 through 2 depending upon the channel.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR> | Turns measure current status on or off, or sets it from a numeric value. |
CH1:AMPSVIAVOLTS:ENABLE ON will change the Ch1 measure current status as Yes.
Sets or queries the measure current status for the specified channel. The status can be turned ON/OFF or set with a numeric value where 0 turns it off and any other value turns it on.
Ch1:AMPSVIOLTS:ENABLE ON will change the Ch1 measure current status as Yes.
Returns the vertical settings for the specified channel. Only CH<x>:SCAle is returned because CH<x>:SCAle and CH<x>:VOLts are identical.
CH1? might return :CH1:SCALE 1.0E0;POSITION 0.0E0; COUPLING DC;BANDWIDTH FULL;PROBE 1.0E0.
Sets or queries the current factor for the specified channel's current measurement conversion. The channel number <x> can vary from 1 through 2 depending upon the channel.
| Name | Type | Values | Description |
|---|---|---|---|
| factor | real | 1 - 2 | Factor value. |
CH<x>:AMPSVIAVOLTs:FACTOR 1
Sets or queries the current factor for the specified vertical current measurement channel. The channel index <x> can vary from 1 through 2 depending on the channel.
Sets or queries the selectable low-pass bandwidth limit filter setting of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on instrument model. This command is equivalent to setting the BW Limit option in the Vertical menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | TWEnty | FULl | Selects 20 MHz bandwidth limiting or disables bandwidth limiting. |
| value | real | - | Double-precision ASCII bandwidth value; the instrument rounds this to an available bandwidth using geometric rounding. |
CH1:BANDWIDTH TWENTY sets the bandwidth of channel 1 to 20 MHz. CH1:BANDWIDTH? might return FULl. This indicates there is no bandwidth limiting on channel 1.
Sets or queries the selectable low-pass bandwidth limit filter setting of the specified instrument channel. The value of x can vary from 1 through 2 depending on instrument model; this command is equivalent to setting the BW Limit option in the Vertical menu.
CH1:BANDWIDTH TWENTY sets the bandwidth of channel 1 to 20 MHz. CH1:BANDWIDTH? might return FULl. This indicates there is no bandwidth limiting on channel 1.
Sets or queries the input attenuator coupling setting of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on the instrument model.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | AC | DC | Coupling setting for the specified channel. |
CH1:COUPLING AC establishes AC coupling on channel 1. CH2:COUPLING? might return :CH2:COUPling DC indicating that channel 2 is set to DC coupling.
Sets or queries the input attenuator coupling setting of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on the instrument model.
CH2:COUPLING? might return :CH2:COUPling DC indicating that channel 2 is set to DC coupling.
Sets or queries the deskew time for channel <x>. The deskew time adds an independent channel-based delay to compensate for different input hookup delays.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | -100 ns - +100 ns | Deskew time for channel <x>. |
CH1 :DESKEW 5.0E-9 sets the deskew time for channel 1 to 5 ns. CH2:DESKEW? might return :CH2:DESKEW 2.0000E-09 indicating that the deskew time for channel 2 is set to 2 ns.
Sets or queries the deskew time for channel <x>. The deskew time adds an independent channel-based delay to compensate for different input hookup delays.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | -100 ns - +100 ns | Deskew time for channel <x>. |
CH1 :DESKew 5.0E-9 CH2:DESKEW? might return :CH2:DESKEW 2.0000E-09
Sets or queries the inversion state of the specified instrument channel. The channel index <x> can vary from 1 through 2 depending on the instrument model.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | ON inverts the specified instrument channel; OFF sets the specified instrument channel to noninverted. |
CH1:INVERT ON inverts the signal on channel 1. CH2:INVERT? might return :CH2:INVERT 0, indicating that channel 2 is not inverted.
Sets or queries the inversion state of the specified instrument channel. The channel number x can be 1 through 2 depending on the instrument model.
CH1:INVERT ON CH2:INVERT?
Sets or queries the waveform label for channel x, where x is the channel number (1-2). The label text is limited to 30 characters and must be enclosed in quotes.
| Name | Type | Values | Description |
|---|---|---|---|
| Qstring | string | - | Alphanumeric text enclosed in quotes for the channel waveform label. |
CH1:LABEL "ICCDATA" sets the label name of Channel 1 waveform output to ICCDATA. CH1:LABEL? might return "ICCDATA", if the channel label was already set, else would return "" if not set.
Sets or queries the waveform label for the specified channel. The label is a quoted text string up to 30 characters.
CH1:LABEL "ICCDATA" sets the label name of Channel 1 waveform output to ICCDATA. CH1:LABEL? might return "ICCDATA", if the channel label was already set, else would return "" if not set.
Sets or queries the vertical offset for channel <x>. It offsets the vertical acquisition window for the specified channel; the valid range depends on the vertical scale factor.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | -0.8 V - 0.8 V | Offset value for the specified channel <x>. |
CH1:OFFSet 2.0E-3 sets the offset for channel 1 to 2 mV. CH2:OFFSet? might return : CH2:OFFSET 1.0000E-03 indicating that the offset for channel 2 is set to 1 mV.
Sets or queries the vertical offset for channel <x>. The offset shifts the vertical acquisition window; the valid range depends on the V/Div setting and probe/external attenuation factor.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | -0.8 V - 0.8 V | Offset value for the specified channel <x>. |
CH1:OFFSet 2.0E-3 CH2:OFFSet?
Sets or queries the vertical position of the specified instrument channel. The value of <x> can vary from 1 through 2 depending on the instrument model, and the position value is applied to the signal before digitization.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Channel number. |
Sets or queries the vertical position of the specified instrument channel. The position value is applied to the signal before digitization and determines the vertical graticule coordinate where the input signal, minus the present offset, is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Channel number. |
Returns all information concerning the probe attached to channel <x>. The channel number <x> can vary from 1 through 2 depending on the instrument model.
CH1:PROBE? might return No probe.
Sets or queries the gain factor for the probe attached to channel <x>. The gain is the output divided by the input transfer ratio.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | - | Gain factor for the probe attached to the specified channel. |
Sets or queries the gain factor for the probe attached to channel <x>. The gain is the probe output divided by the input transfer ratio.
Returns the serial number of the probe attached to channel <x>. For Level 0 and 1 probes, the serial number is empty string ("").
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | - | Channel number. |
CH1:PROBE:ID:SERNUMBER? might return :CH1:PROBE:ID:SERNUMBER "B010289" indicating that the serial number of the probe attached to channel 1 is B010289.
Returns the type and serial number of the probe attached to channel <x>. Query only.
CH2:PROBE:ID? might return :CH2:PROBE:ID:TYPE "10X";SERNUMBER "N/A" indicating that a passive 10x probe of unknown serial number is attached to channel 2.
Returns the type of probe attached to the specified channel. Level 2 or higher probes return their exact product nomenclature; Level 0 or 1 probes return the generic "No Probe Detected" message.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | - | Channel number. |
CH1:PROBE:ID:TYPE? might return :CH1:PROBE:ID:TYPE "P6203" indicating that a P6203-type probe is attached to channel 1.
Sets or queries the input bypass setting of a TekVPI probe attached to channel <x>. The command is ignored if sent to an unsupported probe.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | BYPass | PASS | Input bypass mode for the probe. |
CH1:PRObe:SIGnal PASS set the probe attached to channel 1 to Pass mode. CH1:PRObe:SIGnal? might return :CH1:PRObe:SIGnal PASS indicating that the probe attached to channel 1 is in Pass mode
Sets or queries the input bypass setting of a TekVPI probe attached to channel <x>. The command is ignored if sent to an unsupported probe.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | BYPass | PASS | Selects the probe bypass setting. |
CH1:PRObe:SIGnal PASS CH1:PRObe:SIGnal?
Returns a string describing the units of measure for the probe attached to channel <x>. Query only.
Sets or queries the vertical scale of the specified instrument channel. The value entered is a units-per-division setting and is truncated to three significant digits.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Channel number selected by <x>. |
| scale | real | units-per-division | Vertical scale for the channel. |
CH1:SCALE 100E-3 CH2:SCALE?
Queries the vertical scale of the specified instrument channel. The value of <x> can be 1 through 2 depending on the instrument model.
CH2:SCALE? might return :CH2:SCALE 1.0000, indicating that the current V/div setting of channel 2 is 1 V/div.
Sets or queries the vertical sensitivity of the specified channel. It is identical to CH<x>:SCAle and is included for compatibility purposes; only CH<x>:SCAle is returned in response to a CH<x>? query.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | V | Vertical sensitivity of the channel, in volts. |
CH1:VOLts 1.0 CH1:VOLts?
Sets or queries the vertical sensitivity of the specified channel. This command is identical to CH<x>:SCAle and is included for compatibility purposes; only CH<x>:SCAle is returned in response to a CH<x>? query.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies the channel number. |
| NR3 | real | V | Vertical sensitivity in volts. |
CH1:VOLts 1.0 CH1:VOLts?
Sets or queries the units of the specified channel. String arguments are case insensitive and unsupported units generate an error.
| Name | Type | Values | Description |
|---|---|---|---|
| QString | string | - | A quoted string specifying the supported units. |
CH2:YUNit "V" CH2:YUNIT
Sets or queries the units of the specified channel. String arguments are case-insensitive and unsupported units generate an error.
| Name | Type | Values | Description |
|---|---|---|---|
| units | string | - | A quoted text string specifying the supported units. |
CH2:YUNit "V" sets the units for channel 2 to Volts. CH2:YUNIT might return CH2:YUNIT "V", indicating that the channel 2 units are volts.
Enables or disables the Cursor functions. The function can also be set from the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the cursor feature. |
CURSOR:ENABLE OFF disables cursor. CURSOR:ENABLE? might return 1 indicating that cursor is enabled.
Enables or disables the Cursor functions. The setting can be changed from the Utility menu.
CURSOR:ENABLE OFF disables cursor. CURSOR:ENABLE? might return 1 indicating that cursor is enabled.
Returns the current cursor settings. Query only.
CURSor? might return the following string as the current cursor settings: :CURSOR:FUNCTION SCREEN;HBARS:POSITION1 0.0000;POSITION2 0.0000;UNITS BASE;:CURSOR:MODE INDEPENDENT;VBARS:POSITION1 -19.0006E-6;POSITION2 -18.9994E-6;UNITS SECONDS.
Sets or queries the instrument cursor type. Cursors are attached to the selected waveform in Waveform mode and to the display area in Screen mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | SCREEN | TIME | AMPLitude | Selects the cursor type or removes the cursors from the display. |
CURSor:FUNCtion TIME selects the paired cursors for measuring waveform time. CURSor:FUNCtion? might return CURSOR:FUNCTION SCREEN indicating that the screen cursors are currently selected.
Sets or queries the instrument cursor type. Cursors are attached to the selected waveform in Waveform mode and to the display area in Screen mode.
CURSor:FUNCtion TIME CURSor:FUNCtion? might return CURSOR:FUNCTION SCREEN indicating that the screen cursors are currently selected.
Returns the settings for the instrument horizontal bar cursors. Query only.
CURSor:HBArs? might return the horizontal bar setting as return the horizontal bar setting as CURSOR:HBARS:DELTA 0.0E+0;POSITION1 320.0000E+0;POSITION2 320.0000E+0;UNITS BASE.
Returns the difference between the two horizontal bar cursors in the instrument display. Query only.
CURSOR:HBARS:DELTA? might return :CURSOR:HBARS:DELTA 5.0800E+00 indicating that the difference between the two cursors is 5.08.
Sets or returns the horizontal bar cursor position relative to ground. The cursor position is specified by x, which can be 1 or 2.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which horizontal bar cursor is addressed. |
| position | real | V | Specifies the horizontal bar cursor position relative to ground. |
Sets or returns the horizontal bar cursor position relative to ground. The position is specified by x, which can be 1 or 2, and is limited to the graticule if moved outside it.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Selects horizontal bar cursor 1 or 2. |
Sets or queries the vertical scale units for the selected cursor source waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | BASe | PERcent | Selects the vertical units for the selected waveform or ratio cursors. |
CURSor:HBArs:UNIts? might return :CURSOR:HBARS:UNITS BASE indicating that the units for the horizontal bar cursors are base.
Sets or queries the vertical scale units for the selected cursor source waveform.
CURSor:HBArs:UNIts? might return :CURSOR:HBARS:UNITS BASE indicating that the units for the horizontal bar cursors are base.
Sets the horizontal bar cursor measurement scale. This command is only applicable when ratio cursors are on.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CURrent | HALFgrat | FIVEdivs | Sets the H Bar measurement scale. |
Sets or returns whether the two cursors move linked together in unison or separately. This applies to the waveform cursors display mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TRACk | INDependent | Selects linked cursor movement or independent adjustment. |
CURSOR:MODE TRACK specifies that the cursor positions move in unison. CURSOR:MODE? might return :CURSOR:MODE TRACK indicating that the two cursors move in unison.
Returns or sets whether the two waveform cursors move linked together in unison or separately. This command applies only when waveform cursors are displayed.
CURSOR:MODE? might return :CURSOR:MODE TRACK indicating that the two cursors move in unison.
Returns the current vertical bar cursor horizontal position and units settings. Query only.
CURSor:VBArs?
Returns the alternate readout for the waveform (Vbar) cursors specified by <x>. This alternate readout is in effect for a bus waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which vertical bar cursor to query. |
CURSor:VBArs:ALTERNATE1? might return 1.001 indicating the vertical bar cursor 1 readout is 1.001.
Returns the time or frequency difference between the two vertical bar cursors. The units are seconds or Hertz, as specified by CURSor:VBArs:UNIts; for an FFT math waveform, it is always in Hertz. Query only.
CURSor:VBArs:DELTa? might return 8.92E-1, indicating that the time difference between the vertical bar cursors is 0.892 seconds.
Returns the horizontal value of the specified vertical bar tick for cursor <x>. The units are specified by CURSor:HBArs:UNIts.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies the cursor to query. |
CURSOR:VBARS:HPOS1? might return CURSOR:VBARS:HPOS2 100E-3, indicating the value of one vertical bar tick.
Positions a vertical bar cursor. The position is set in the units specified by CURSor:VBArs:UNIts, and may be in seconds or Hertz depending on the cursor source. If Trigger View is active, the query form returns 9.9E37 and generates event 221.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which cursor to position. |
| position | real | - | Cursor position in the units specified by CURSor:VBArs:UNIts. |
CURSOR:VBARS:POSITION2 9.00E-6 positions the second vertical bar cursor at 9ms.
Positions a vertical bar cursor using the units specified by CURSor:VBArs:UNIts; the position is relative to the trigger except for FFT math waveforms, which are always in Hertz. If Trigger View is active, the query form returns 9.9E37 and generates event 221 (Settings conflict).
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which cursor to position. |
| position | real | - | Specifies the cursor position in the units set by CURSor:VBArs:UNIts. |
CURSOR:VBARS:POSITION2 9.00E-6 positions the second vertical bar cursor at 9ms.
Sets or queries the units for the vertical bar cursors. When Trigger View is active, the query generates event 221 (Settings conflict).
| Name | Type | Values | Description |
|---|---|---|---|
| units | enum | SECOnds | HERtz | Specifies the units for the vertical bar cursors. |
CURSor:VBArs:UNIts SECONDS sets the units for the vertical bar cursors to seconds. CURSor:VBArs:UNIts? returns HERTZ when the vertical bar cursor units are Hertz.
Sets or queries the units for the vertical bar cursors.
CURSor:VBArs:UNIts SECONDS CURSor:VBArs:UNIts?
Returns the vertical (amplitude) difference between the two vertical bar cursors. The units are specified by the CURSor:HBArs:UNits query.
Transfers waveform data to and from the instrument in binary or ASCII format. The CURVe? query sends waveform data from the instrument, and the CURVe command transfers waveform data from an external device to the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| <Block>|<asc curve>opt | block | - | Waveform data in binary or ASCII format. |
CURVe {<Block>|<asc curve>}
CURVe?Transfers waveform data to and from the instrument in binary or ASCII format. For analog waveforms, the CURVe? query sends data from the instrument to an external device using the data source and start/stop settings.
:CURVE 61,62,61,60,60,-59,-59,-58,-58,-59.
Queries out the waveform points for later analysis on the controller computer.
:CURVE?
Sets or queries the format and location of the waveform data that is transferred with the CURVe command.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INIT | SNAp | Initializes waveform data settings or snaps start/stop to the current cursor positions. |
DATa INIT initializes the waveform data settings to their factory defaults. DATa? might return :DATA:DESTINATION REF1:ENCDG RIBINARY;SOURCE CH1;START 1;STOP 500;WIDTH 1.
Sets or queries the reference memory location used for storing waveform data transferred into the instrument by the CURVe command.
| Name | Type | Values | Description |
|---|---|---|---|
| REF<x> | - | - | Reference memory location. |
Sets or queries the reference memory location used for waveform data transferred into the instrument by the CURVe command.
Sets or queries the format and location of the waveform data transferred with the CURVe command.
DATa? might return :DATA:DESTINATION REF1:ENCDG RIBINARY;SOURCE CH1;START 1;STOP 500;WIDTH 1.
Sets or queries which waveform will be transferred from the instrument by the CURVe? query. Only one waveform can be transferred at a time.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CH1 | CH2 | MATH | REF1 | REF2 | Selects the waveform source to be transferred. |
DATa:SOUrce CH1 DATa:SOUrce REF1 DATa:SOUrce?
Sets or queries which waveform will be transferred from the instrument by the CURVe? query. Only one waveform can be transferred at a time.
DATa:SOUrce CH1 DATa:SOUrce REF1 DATa:SOUrce?
Sets or queries the starting data point for incoming or outgoing waveform transfer. This command lets you transfer partial waveforms to and from the instrument.
Sets or queries the starting data point for incoming or outgoing waveform transfer. This command lets you transfer partial waveforms to and from the instrument.
Sets or queries the last data point in the waveform that will be transferred when using the CURVe? query. It lets you transfer partial waveforms from the instrument; if the value exceeds the record length, transfer goes to the record length.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 1 - record length | Last data point to be transferred. |
Queries the last data point in the waveform that will be transferred when using the CURVe? query. If the value is greater than the record length, data is transferred up to the record length; if both DATa:STARt and DATa:STOP are greater than the record length, the last data point in the record is returned.
Sets or queries the number of bytes per data point in waveform data transferred using the CURVe command. The allowed values are 1 byte (8 bits) or 2 bytes (16 bits).
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 1 - 2 | Number of bytes per waveform data point; 1 selects 1 byte and 2 selects 2 bytes. |
DATa:WIDth 1
Sets or queries the number of bytes per data point in waveform data transferred using the CURVe command. Valid values are 1 byte or 2 bytes per point.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 1 - 2 | Number of bytes per waveform data point. |
DATa:WIDth 1
Sets or queries the instrument date value. The instrument uses this value to time stamp files saved to the USB flash drive and to show the time and date on the instrument display.
Sets or queries the instrument date value. The instrument uses this value to time stamp files saved to the USB flash drive and to show the time and date on the instrument display.
Sets or queries the bits in the Device Event Status Enable Register (DESER). The register mask determines whether events are reported to the Standard Event Status Register and entered into the Event Queue.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Integer value used to set the DESER bits. |
DESE 209
Reads the Device Event Status Enable Register (DESER). The DESER controls which types of events are reported to the SESR and the Event Queue.
Enables or disables bits in the Device Event Status Enable Register (DESER). The DESER controls which types of events are reported to the SESR and the Event Queue.
| Name | Type | Values | Description |
|---|---|---|---|
| enable_bits | integer | 0 - 255 | Bit pattern written to the DESER. |
Returns the currently set PWM fan value.
Sets the self-test loop option. It selects how diagnostics self-tests loop, with choices for always, fail, on failure, once, or N times.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ALWAYS | FAIL | ONFAIL | ONCE | NTIMES | Selects the self-test loop behavior. |
DIAg:LOOP:OPTion ONCE sets diagnostics to run one loop of self tests.
Sets the self-test loop option to run N times.
Sets or queries the number of self-test loops.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | - | Number of self-test loops. |
DIAG:LOOP:OPTION:NTIMES 3 DIAG:LOOP:OPTION:NTIMES?
Stops the self-test at the end of the current loop. No query form.
DIAG:LOOP:STOP stops the self test at the end of the current loop.
Returns the Pass/Fail status from the last diagnostic test sequence execution. Use DIAg:RESUlt:LOG? to determine which test(s) has failed.
DIAg:RESUlt:FLAG
Returns the internal results log from the last diagnostic test sequence execution. The list contains all modules and module interfaces that were tested with the pass or fail status of each.
DIAg:RESUlt:LOG? might return :DIAG:RESULT:LOG "NOT RUN--CPU,NOT RUN--DISPLAY,NOT RUN--FPANEL,NOT RUN--IO,NOT RUN--ACQ,NOT RUN--ROM,NOT RUN--APPKEY" for power-up diagnostics.
Sets the type of diagnostics grouping. No query form.
| Name | Type | Values | Description |
|---|---|---|---|
| group | enum | ALL | APPKey | CPU | DISplay | FPAnel | IO | ROM | ACQ | Selects which diagnostic group to run. |
Runs self-tests on the specified system subsystem. No query form.
| Name | Type | Values | Description |
|---|---|---|---|
| function | enum | ACQ | CPU | DISplay | FPAnel | IO | ROM | Specifies a single instrument subsystem on which to run self tests (diagnostics). |
DIAg:SELect:ACQ specifies to run self tests on the acquisition system.
Starts or stops the instrument self-test. Depending on the argument, self-test capabilities are turned on or off; no query form is available.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | EXECute | ABORt | Controls whether diagnostics are started or stopped. |
DIAG:STATE EXECute starts diagnostics.
Read out the currently FPGA chip and ambient temperature. Only query.
DIAG:TEMPVAL? might return: VDC Temp=-256, Ambient Temp=32
Sets or queries the display graticule intensity setting. A nonzero value or ON turns the graticule on; 0 or OFF turns it off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the graticule on or off. |
DISPLAY:GRATICULE 0 sets NO graticule to display. DISPLAY:GRATICULE? might return :DISPLAY:GRATICULE 1 indicating that the graticule is on.
Sets and queries the display graticule setting. ON or a nonzero numeric value turns the graticule on; OFF or 0 turns it off.
DISPLAY:GRATICULE 0 sets NO graticule to display. DISPLAY:GRATICULE? might return :DISPLAY:GRATICULE 1 indicating that the graticule is on.
Sets the waveform backlight intensity settings. The manual also shows a query form with an NR1 argument, but does not document what it returns.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | real | - | Backlight intensity value. |
Sets or returns the display persistence to ON or OFF. The query form returns the persistence state. This affects the display only.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns display persistence on or off. |
| value | integer | 0 | Numeric persistence state; 0 turns persistence off, any other value turns it on. |
DISplay:PERSistence:STATe ON turns on the persistence on the display for all waveforms. DISplay:PERSistence:STATe? might return 1 indicating that the persistence is ON for the display.
Returns or sets the display persistence state. The query form returns the persistence state and affects the display only.
DISplay:PERSistence:STATe? might return 1 indicating that the persistence is ON for the display.
Sets the persistence value if the persistence state is on. This affects the display only.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Persistence time value. |
| mode | enum | AUTO | INFInite | Selects automatic or infinite persistence. |
Sets the persistence value when persistence is turned on. The query form returns the persistence value; AUTO selects an automatic persistence based on waveform intensity, and INFInite displays waveform points until a control change resets the acquisition system.
DISplay:PERSistence:VALUe 3 specifies that the waveform points are displayed fading for 3 seconds before they completely disappear.
Returns the first entry in the error log, or an empty string if the error log is empty. Use with ERRLOG:NEXT? to retrieve error log messages.
Returns the next entry in the error log, or an empty string if the error log is empty or the end of the log has been reached. Use ERRLOG:FIRST? to start at the top of the error log, then step through with ERRLOG:NEXT?.
Removes a single event code from the Event Queue associated with the last *ESR? read, and returns the event code with an explanatory message. Query only.
EVMsg? might return the message EVMSG 110, "Command header error"
Reads the event number and a text description of the event from the Event Queue. Reading an event removes it from the queue.
Returns the number of event codes in the Event Queue. This query is useful with ALLEv? to determine exactly how many events will be returned.
EVQty? might return :EVQTY 3 indicating the number of event codes in the Event Queue is 3.
Checks whether the entered password matches the preset Feature Enable password, which allows enabling or disabling features such as Autoset, Cursors, or Measurements. No query form.
| Name | Type | Values | Description |
|---|---|---|---|
| password | string | - | Password entered for Feature Enable. |
Sets or queries the FFT horizontal display position.
Sets or queries the FFT horizontal display position.
Returns all FFT parameters. Query only.
FFT? might return 1; CH1; 20; 0.000; "dB"; 250.000E+3; 750.000E+3; "Hz";1;HANNING;X1;DB
Sets or queries the horizontal scale of the FFT waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | - | The FFT horizontal scale. |
FFT:HORizontal:SCALe 500.00E+6 sets the FFT horizontal scale to 500 MHz. FFT:HORizontal:SCALe? might return 500.00E+6 indicating the FFT horizontal scale is set to 500 MHz.
Sets or queries the horizontal scale of the FFT waveform.
FFT:HORizontal:SCALe 500.00E+6 sets the FFT horizontal scale to 500 MHz. FFT:HORizontal:SCALe? might return 500.00E+6 indicating the FFT horizontal scale is set to 500 MHz.
Sets or queries the source of the FFT waveform.
Sets the FFT source channel. The source may be CH1 or CH2.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | CH1 | CH2 | FFT source channel. |
FFT:SOURce ch2 sets the FFT source waveform to CH2. FFT:SOURce? might return "CH2" if CH2 is the FFT source waveform.
Sets or queries the FFT source waveform display state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | NR1 | Controls whether the FFT source waveform is displayed. |
FFT:SRCWFM 0 turns off the display of the FFT source waveform. FFT:SRCWFM? might return 1 indicating the FFT source waveform is displayled.
Sets or queries the FFT vertical display position.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | The FFT vertical position. |
FFT:VERTical:POSition 2 sets the FFT vertical position to 2 divisions above center screen.
Sets or queries the FFT vertical zoom factor.
| Name | Type | Values | Description |
|---|---|---|---|
| NR2 | real | - | The FFT vertical scale. |
FFT:VERTical:SCAle 20 FFT:VERTical:SCAle?
Queries the FFT vertical measurement units label.
FFT:VERTical:UNIts? might return dB indicating the FFT vertical units are set to dB.
Sets the FFT waveform vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DB | LINEAr | Selects the FFT waveform vertical units. |
Sets the FFT waveform vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DB | LINEAr | Selects the FFT waveform vertical units. |
Sets or queries the FFT window type.
| Name | Type | Values | Description |
|---|---|---|---|
| window | enum | HAMming | HANning | RECTangular | BLAckmanharris | FFT window function type. |
FFT:WINdow HAMMING sets the FFT window to Hamming. FFT:WINdow? might return HAMMING.
Queries the FFT window type. The query returns the currently selected window function.
FFT:WINdow? might return HAMMING.
Returns the current working directory and the amount of free space. This query is the same as the FILESystem:DIR? query and the FILESystem:FREESpace? query.
Sets or queries the current working directory for FILESystem commands. The default working directory is USB0, and the directory remains current until changed or deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| new working directory path | string | - | Quoted string that defines the current working directory; a directory name can have up to 8 characters with an extension of up to 3 characters. |
FILESYSTEM:CWD " USB0/TEKSCOPE/IMAGES" sets the current working directory to images. FILESYSTEM:CWD? might return :FILESYSTEM:CWD " USB0/TEKSCOPE/WAVEFORMS" indicating that the current working directory is set to waveforms.
Sets or queries the current working directory for FILESystem commands. The default working directory is USB0, and the specified directory remains current until changed or deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| new working directory path | string | - | Quoted string that defines the current working directory; a directory name can have up to 8 characters with an extension of up to 3 characters. |
FILESYSTEM:CWD " USB0/TEKSCOPE/IMAGES" FILESYSTEM:CWD? might return :FILESYSTEM:CWD " USB0/TEKSCOPE/WAVEFORMS"
Deletes a named file or directory. If you specify a directory name, it deletes the directory and all of its contents; *.* deletes all files in the current or specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| filename | string | - | Name of the file or directory to delete. |
Returns a list of quoted strings for the names of files and directories in the current working directory. Query only.
FILESystem:DIR? might return :FILESYSTEM:DIR "TEK00000.PNG","CANSETUP.SET","WFM1.ISF","MYIMAGES".
Formats a mass storage device. Use with extreme caution because it erases all data on the specified device. Drive letters such as USB0 are case sensitive and must be upper case.
| Name | Type | Values | Description |
|---|---|---|---|
| drive | string | - | Mass storage device to format, specified as a quoted drive path such as USB0/. |
FILES:FORMAT " USB0/"
Returns the available memory space on the current drive in bytes. Query only.
FILESystem:FREESpace? might return 6242501.
Creates a folder at the specified location. Command only, no query form.
| Name | Type | Values | Description |
|---|---|---|---|
| directory path | string | - | The directory path where the folder is created. |
Writes the contents of the specified file to the specified interface. If the file does not exist or is not readable, an appropriate error event is posted.
| Name | Type | Values | Description |
|---|---|---|---|
| QString | string | - | Quoted string that defines the file name and path. If the file path is within the current working directory, specify only the file name. |
FILESYSTEM:READFILE “USB0/TEST_DATA/TEK00016CH1.CSV” reads the content of the specified file, if the file exists and is readable, and sends the content of the file to the current interface.
Assigns a new name to an existing file or folder. You can also move a file or folder by specifying the new name in a different folder.
| Name | Type | Values | Description |
|---|---|---|---|
| new name | string | - | New file or folder name, optionally including a different folder path. |
Deletes a named directory and all of its contents. The directory must not be read-only, and it must be empty before it can be deleted.
| Name | Type | Values | Description |
|---|---|---|---|
| directory path | string | - | Quoted string that defines the location and name of the directory to delete. |
FILESYSTEM:RMDIR " USB0/OldDirectory" removes the directory named olddirectory from the root of the E drive.
Writes the specified block data to a file in the instrument current working directory. If the file does not exist or is not readable, an error event is posted.
| Name | Type | Values | Description |
|---|---|---|---|
| file path | string | - | Quoted string that defines the file name and path. If the path is within the current working directory, specify the file name only. |
| data | block | - | Block data to write; may use definite-length encoding or indefinite-length arbitrary block program data encoding as described in IEEE488.2. |
Simulates pressing a specified front-panel button. No query form. When the front panel is locked, this command does not work.
| Name | Type | Values | Description |
|---|---|---|---|
| button | enum | ACQuire | SAVE Recall | MEASurement | UTILity | Name of the front-panel button to press. |
Simulates the action of turning a specified front-panel control knob. No query form.
FPANEL:PRESS AUTOSET executes the instrument Autoset function.
Updates the oscilloscope firmware from a file on a USB flash drive. The USB flash drive must be plugged into the instrument and contain the firmware update file TBS1000C.TEK in the root directory.
Sets and queries the Response Header Enable State, which controls whether query responses include headers. It does not affect IEEE Std 488.2-1987 Common Commands.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables response headers on applicable query responses. |
HEADer OFF HEADer?
Queries the Response Header Enable State, which controls whether query responses include headers. This does not affect IEEE Std 488.2-1987 Common Commands.
HEADer? might return 1, showing that the Response Header Enable State is true. Query only.
Enables or disables the display of Help Everywhere information for the acquire measurements.
Enables or disables the display of Help Everywhere information for acquire measurements.
Enables or disables the display of Help Everywhere information for all measurement settings, including acquire, trigger, vertical, math, fft, cursor, reference, measurement, and utility modules.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere. |
HELPevery:ALL ON enables Help Everywhere.
Enables or disables the display of Help Everywhere information for the cursor module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the cursor settings. |
HELPevery:CURsor ON
Enables or disables the display of Help Everywhere information for the cursor module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Help Everywhere for cursor settings on or off. |
Enables or disables the display of Help Everywhere information for the FFT module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the FFT module. |
HELPevery:FFT ON enables Help Everywhere for the FFT module.
Enables or disables the display of Help Everywhere information for the FFT settings.
HELPevery:FFT ON
Enables or disables the display of Help Everywhere information for the math module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Help Everywhere for the math module on or off. |
HELPevery:MATH ON enables Help Everywhere for the math module.
Enables or disables the display of Help Everywhere information for the math module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Help Everywhere for the math module on or off. |
HELPevery:MATH ON enables Help Everywhere for the math module.
Enables or disables the display of Help Everywhere information for the measurement module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the measurement module. |
HELPevery:MEASUrement ON enables Help Everywhere for the measurement module.
Enables or disables the display of Help Everywhere information for the measurement module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the measurement module. |
HELPevery:MEASUrement ON enables Help Everywhere for the measurement module.
Enables or disables the display of Help Everywhere information for the reference module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the reference module. |
HELPevery:REFerence ON enables Help Everywhere for the reference module.
Enables or disables the display of Help Everywhere information for the reference module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Help Everywhere display for the reference module on or off. |
HELPevery:REFerence ON
Enables or disables the display of Help Everywhere information for the trigger module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Help Everywhere for the trigger module on or off. |
Returns the Help Everywhere state for the trigger module. The command enables or disables the display of Help Everywhere information for the trigger module.
Enables or disables the display of Help Everywhere information for the utility module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the utility module. |
HELPevery:UTIlity ON enables Help Everywhere for the utility module.
Enables or disables the display of Help Everywhere information for the utility module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the utility module. |
HELPevery:UTIlity ON
Enables or disables the display of Help Everywhere information for the vertical module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the vertical module. |
Enables or disables the display of Help Everywhere information for the vertical module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the vertical module. |
Queries the record length. Query only.
Returns all horizontal settings. Query only.
HORIZONTAL? might return the following horizontal settings :HORIZONTAL:POSITION 50.0000; SAMPLERATE 500.0000E+6; SCALE 200.0000E-9; RECORDLENGTH 2000; RECORDLENGTH : AUTO 0; DELAY:MODE 1; TIME 0.0E+0.
Returns the current horizontal divisions. Query only.
HORizontal:DIVisions? might return 15.
Sets or queries the horizontal position. When Horizontal Delay Mode is off, it is equivalent to adjusting the front-panel Horizontal Position knob; when Delay Mode is on, it stores a new horizontal position used when Delay Mode is turned off.
| Name | Type | Values | Description |
|---|---|---|---|
| position | integer | % | Horizontal position expressed as the percentage of the waveform displayed left of the center of the graticule. |
HORIZONTAL:DELay:POSITION 50 sets the horizontal position to 50%. HORIZONTAL:MAIn:DELay:POSITION? might return 100 indicating that the horizontal position is set to 100%.
Sets or queries the horizontal position. When Horizontal Delay Mode is off, it is equivalent to adjusting the front-panel HORIZONTAL POSITION knob; when Delay Mode is on, it stores a new position used when the mode is turned off.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR1> | real | - | Horizontal position expressed as the percentage of the waveform displayed left of the center of the graticule. |
HORIZONTAL:MAIn:DELay:POSITION? might return 100 indicating that the horizontal position is set to 100%.
Sets or returns the horizontal delay mode. The manual states this command is the same as HORizontal[:MAIn]:DELay:MODe.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | Sets the horizontal delay mode off or on. |
| value | integer | 0 | Numeric value where 0 sets the mode off and any other value sets it on. |
HORizontal:DELAY:MODE OFF HORIZONTAL:MAIn:DELAY:MODE?
Returns the horizontal delay mode. The mode determines whether horizontal position or horizontal delay time positions the waveform.
HORIZONTAL:DELAY:MODE? HORIZONTAL:MAIn:DELAY:MODE? might return OFF indicating that the HORizontal:POSition command horizontally positions the waveform.
Sets or returns the horizontal delay state. The same as HORizontal[:MAIn]:DELay:MODe.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | <NR1> | Sets the horizontal delay state. |
Sets or returns the horizontal delay state. The same as HORizontal[:MAIn]:DELay:MODe.
Sets or returns the horizontal delay mode. OFF lets HORizontal:POSition horizontally position the waveform; ON lets HORizontal:DELay:TIMe do so.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | ON | Sets the horizontal delay mode to off or on. |
| value | real | - | <NR1> value where 0 sets the mode to off and any other value sets it to on. |
HORIZONTAL:DELAY:MODE OFF HORIZONTAL:MAIn:DELAY:MODE?
Returns or sets the horizontal delay mode.
HORIZONTAL:MADELAY:MODE? might return OFF indicating that the HORizontal:POSition command horizontally positions the waveform.
Sets or returns the horizontal delay state. This is the same as HORizontal[:MAIn]:DELay:MODe.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | <NR1> | Sets the horizontal delay state. |
Sets or returns the horizontal delay state. This command is the same as HORizontal[:MAIn]:DELay:MODe.
Sets or queries the horizontal delay time. The amount of time the acquisition is delayed depends on sample rate and record length.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | s | The delay time in seconds. |
HORizontal:DELay:TIME 0.3 sets the delay of acquisition data so that the resulting waveform is centered 300 ms after the trigger occurs.
Sets or queries the horizontal delay time. The amount of time the acquisition is delayed depends on sample rate and record length.
| Name | Type | Values | Description |
|---|---|---|---|
| delay time | real | s | Delay in seconds. |
HORizontal:DELay:TIME 0.3
Returns the current horizontal sample rate. Query only.
Returns the current horizontal sample rate. Query only.
Sets or queries the time base horizontal scale. Query only.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 2 ns - 100 s | Specifies the range, depending on the model. |
HORizontal:MAIn:SCAle 2E-6 sets the main scale to 2 μs per division. HORizontal:MAIn:SCAle? might return 2.0000E-06, indicating that the main scale is currently set to 2 μs per division.
Sets or queries the time base horizontal scale. This command is query only.
HORizontal:MAIn:SCAle? might return 2.0000E-06, indicating that the main scale is currently set to 2 μs per division.
Sets the time per division for the main time base. This command is identical to HORizontal:MAIn:SCAle and is provided to maintain program compatibility with some older models.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | 2 ns - 100 s | Specifies the time base horizontal scale. |
Sets the time per division for the main time base. This command is identical to HORizontal:MAIn:SCAle and is provided to maintain program compatibility with some older models of Tektronix scopes.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 2 ns - 100 s | Range from 2 ns to 100 s, depending on the model. |
Returns the current horizontal unit. Query only.
HORizontal:MAIn:UNIts? might return SECONDS.
Returns the current horizontal unit. Query only.
HORizontal:MAIn:UNIts? might return SECONDS.
Returns the current horizontal unit. Query only.
Returns a boolean value indicating whether the acquisition system is in the preview state. Query only.
HORizontal:PREViewstate? might return 1 indicating the acquisition system is in the preview state.
Sets the horizontal record length of acquired waveforms. The query form returns the current horizontal record length.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR1> | integer | 1000 - 20000 | Supported horizontal record length value. |
HORizontal:RECOrdlength 2000 HORizontal:RECOrdlength? might return 2000
Sets or queries the horizontal record length mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | integer | 0 - 1 | 1 enables auto record length mode, 0 disables auto record length mode. |
Sets or queries the horizontal record length mode. A value of 1 enables auto record length mode and 0 disables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | integer | 0 - 1 | Sets the record length mode. |
HORizontal:RECOrdlength:Auto 1 enables auto record length mode of the analog channels. HORizontal:RECOrdlength:Auto? might return 0 indicating that auto record length mode of the analog channels is off.
Returns the current horizontal record length of acquired waveforms. The setter form sets the horizontal record length.
HORIZONTAL:RECORDLENGTH 2000 HORIZONTAL:RECORDLENGTH?
Sets or returns the horizontal record length of acquired waveforms. The sample rate is automatically adjusted at the same time to maintain a constant time per division.
Sets or returns the horizontal record length of acquired waveforms. The sample rate is automatically adjusted to maintain a constant time per division; the query form returns the current horizontal record length.
Returns the current horizontal roll mode state as on or off. Query only.
HORizontal:ROLL? might return HORizontal:ROLL ON indicating that roll mode is on.
Sets or queries the horizontal position when delay mode is OFF. It is similar to HORizontal:POSition.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | % | Horizontal position expressed as the percentage of the waveform displayed left of the center of the graticule. |
HORizontal:MAIn:POSition 50 sets the horizontal position to 50%. HORizontal:MAIn:POSition? might return 100, indicating that the horizontal position is set to 100%.
Sets or queries the horizontal position when delay mode is OFF. It is similar to HORizontal:POSition.
HORizontal:MAIn:POSition 50 sets the horizontal position to 50%. HORizontal:MAIn:POSition? might return 100, indicating that the horizontal position is set to 100%.
Returns identifying information about the instrument and its firmware in Tektronix Codes and Formats notation. Query only.
ID? might return the following response ID TEK/TBS2104,CF:91.1CT,FV:v2015-12-10_01-00-59rootfs; FPGA:v1.21;
Sets the math waveform definition for the active math operation. The <QString> value must be enclosed in quotes, and white space characters may be used between words.
| Name | Type | Values | Description |
|---|---|---|---|
| QString | string | - | Math waveform definition string. |
Returns the current math parameters. Query only.
MATH? might return “CH1+CH2”;2.000;0.0E+0”V”,20.0000E-6;0.0E0;”s”.
Specifies a math waveform. The waveform can be one of CH1+CH2, CH1-CH2, CH2-CH1, or CH1*CH2.
| Name | Type | Values | Description |
|---|---|---|---|
| QString | enum | CH1+CH2 | CH1-CH2 | CH2-CH1 | CH1*CH2 | Specifies the math waveform. |
MATH:DEFINE "CH1-CH2" sets the math waveform so that it displays the difference of channel 1 and channel 2. MATH:DEFine? Might return “CH1-CH2”.
Sets or queries the math horizontal display position for math waveforms. The position is specified as a percentage of the record.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR2> | real | percent | Math horizontal position in percent of record. |
MATH:HORizontal:POSition 20 sets the math horizontal position to 20% of the record. MATH:HORizontal:POSition? might return 20.000 indicating that the math horizontal position is at 20% of the record.
Sets or queries the math horizontal display position for math waveforms. The position is specified as a percent of record.
MATH:HORizontal:POSition 20 MATH:HORizontal:POSition? might return 20.000
Sets or queries the math horizontal display scale for dual math waveforms that only have source waveforms. For dual math waveforms with a channel source waveform, use HORizontal:SCAle instead.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | - | Math horizontal display scale. |
MATH:HORizontal:SCALe <NR3> MATH:HORizontal:SCALe?
Sets or queries the math horizontal display scale for dual math waveforms that only have source waveforms. The horizontal scale of a dual math waveform with a channel source waveform is set through the HORizontal:SCAle command.
Queries the math horizontal measurement units label.
MATH:HORizontal:UNIts? might return “us” indicating the math horizontal units are μs.
Sets or queries the waveform label for the math waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| qstring | string | - | Quoted string used as the label for the math waveform. |
MATH:LABEL Output sets the label for the math waveform to "Output." MATH:LABEL? might return MATH:LABEL "Sum of channel 1 and channel 2" indicating the current label for the math waveform.
Sets or queries the waveform label for the math waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| Qstring | string | - | Quoted string used as the label for the math waveform. |
MATH:LABEL? might return MATH:LABEL "Sum of channel 1 and channel 2" indicating the current label for the math waveform.
Sets or queries the math waveform display position.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | - | Specifies the math vertical position in divisions from center screen. |
MATH:VERtical:POSition 4 MATH:VERtical:POSition? might return -3.000
Sets or queries the math waveform display position.
Sets or queries the vertical display scale for the math waveform display. The display scale is the same as the instrument vertical scale knob and is distinct from the math waveform vertical scale in the math waveform preamble.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | - | Math vertical scale in units per division. |
MATH:VERtical:SCAle 5.0E0 MATH:VERTical:SCALe?
Sets or queries the vertical display scale for the math waveform display. The display scale is in units per division and is distinct from the math waveform vertical scale in the math waveform preamble.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | - | Math vertical scale in units per division. |
MATH:VERtical:SCAle 5.0E0 MATH:VERTical:SCALe? might return 5.000.
Queries the math vertical measurement units.
Returns the current MEASUrement settings. Query only.
MEASUrement? might return the following: :MEASUREMENT:IMMED:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:IMMED:TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH2;:MEASUREMENT:MEAS1:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS1:STATE 1;TYPE FREQUENCY;UNITS "Hz";SOURCE1 CH1;SOURCE2 CH2;COUNT 0;MAXIMUM 0.0000;MEAN 0.0000;MINIMUM 0.0000;STDDEV 0.0000;:MEASUREMENT:MEAS2:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS2:STATE 1;TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH2;COUNT 0;MAXIMUM 0.0000;MEAN 0.0000;MINIMUM 0.0000;STDDEV 0.0000;:MEASUREMENT:MEAS3:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS3:STATE 1;TYPE PK2PK;UNITS "V";SOURCE1 CH1;SOURCE2 CH2;COUNT 0;MAXIMUM 0.0000;MEAN 0.0000;MINIMUM 0.0000;STDDEV 0.0000;:MEASUREMENT:MEAS4:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE;:MEASUREMENT:MEAS4:STATE 0;TYPE PERIOD;UNITS "s";SOURCE1 CH1;SOURCE2 CH2;COUNT 0;MAXIMUM 0.0000;MEAN 0.0000;MINIMUM 0.0000;STDDEV 0.0000;:MEASUREMENT:METHOD AUTO;REFLEVEL:METHOD PERCENT;ABSOLUTE:HIGH 0.0000;LOW 0.0000;MID1 0.0000;MID2 0.0000;:MEASUREMENT:REFLEVEL:PERCENT:HIGH 90.0000;LOW 10.0000;MID1 50.0000;MID2 50.0000;:MEASUREMENT:INDICATORS:STATE OFF;NUMHORZ 0;NUMVERT 0;HORZ1 99.0000E+36;HORZ2 99.0000E+36;HORZ3 99.0000E+36;HORZ4 99.0000E+36;VERT1 99.0000E+36;VERT2
Clears the existing measurement snapshot results and removes the snapshot window. Command only; no query form.
MEASUrement:CLEARSNapshot
Enables or disables the Measurement functions. The setting can be changed from the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the measurement feature. |
MEASUrement:ENABLE OFF disable measurement. MEASUrement:ENABLE? might return 1 indicating that measurements is enabled.
Enables or disables the Measurement functions. The function can also be manually set from the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the measurement feature on or off. |
MEASUrement:ENABLE OFF disable measurement. MEASUrement:ENABLE? might return 1 indicating that measurements is enabled.
Sets or queries the measurement gating setting.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | SCREen | CURSor | Selects whether measurement gating is off, uses the screen edges, or uses the vertical bar cursors. |
MEASUREMENT:GATING CURSOR MEASUREMENT:GATING? might return :MEASUREMENT:GATING CURSOR indicating that measurements are limited to the portion of the waveform between the vertical bar cursors.
Sets or queries the measurement gating setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | SCREen | CURSor | Measurement gating mode. |
MEASUREMENT:GATING CURSOR MEASUREMENT:GATING?
Returns all immediate measurement setup parameters. This is a query only, and an immediate measurement selection is not visible or accessible from the display screen or front panel.
Sets or queries the slope of the edge used for an immediate delay measurement. The suffix <x> selects the waveform: 1 for the from waveform and 2 for the to waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which waveform to use; 1 is the from waveform and 2 is the to waveform. |
| edge | enum | FALL | RISe | Selects the edge slope used for the delay measurement. |
MEASUREMENT:IMMED:DELAY:EDGE1 RISE MEASUREMENT:IMMED:DELAY:EDGE1? returns either RISE or FALL.
Sets or queries the slope of the edge used for the immediate delay measurement from or to a waveform. The suffix <x> selects the waveform: 1 for the from waveform and 2 for the to waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which waveform to use: 1 is the from waveform, 2 is the to waveform. |
| edge | enum | FALL | RISe | Selects whether the falling or rising edge is used. |
MEASUREMENT:IMMED:DELAY:EDGE1 RISE specifies that the from waveform rising edge be used for the immediate delay measurement. MEASUREMENT:IMMED:DELAY:EDGE1? returns either RISE or FALL.
Returns information about the immediate delay measurement. This command is query only and is equivalent to viewing the delay measurement settings on the measurement readout.
MEASUREMENT:IMMED:DELAY? might return :MEASUREMENT:IMMED:DELAY:DIRECTION FORWARDS; EDGE1 RISE; EDGE2 RISE.
Sets or queries the source for single-source immediate measurements, and specifies the source to measure from for immediate delay or phase measurements. If no numerical suffix is specified, SOURCE1 is assumed.
Sets or queries the source for all single source immediate measurements and specifies the source to measure from when taking an immediate delay or phase measurement. If no numerical suffix is specified, source 1 is assumed.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH<x> | MATH | Measurement source to use. |
MEASUREMENT:IMMED:SOURCE1 CH1 specifies channel 1 as the immediate measurement source. MEASUREMENT:IMMED:SOURCE1? might return CH2 indicating that channel 2 is the immediate measurement source.
Sets or queries the immediate measurement type.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AMPlitude | AREa | BURst | CARea | CMEan | CRMs | DELay | FALL | FREQuency | HIGH | LOW | MAXimum | MEAN | MINImum | NDUty | NEDGECount | NOVershoot | NPULSECount | NWIdth | PEDGECount | PDUty | PERIod | PHAse | PK2Pk | POVershoot | PPULSECount | PWIdth | RISe | RMS | Immediate measurement type to set. |
Sets or queries the immediate measurement type.
Returns the units for the immediate instrument measurement. Query only.
MEASUrement:IMMed:UNIts?
Returns the value of the measurement specified by the `MEASUrement:IMMed:TYPe` command. The measurement is immediately taken on the source(s) specified by `MEASUrement:IMMed:SOUrce1`.
MEASUrement:IMMed:VALue? might return 28.75E6 if you are measuring the frequency of a 28.75 MHz signal. MEASUrement:IMMed:VALue? might return 9.9000E+37. If the measurement has an error or warning associated with it, then an item is added to the error queue. The error can be checked for with the *ESR? and ALLEv? commands..
Returns all measurement parameters for the displayed instrument periodic measurement specified by <x>. <x> identifies the measurement number, from 1 through 6 depending on instrument model.
Sets or queries the slope of the edge used for the delay measurement waveform specified by <x>. <x>=1 selects the "from" waveform and <x>=2 selects the "to" waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FALL | RISe | Selects the edge slope used for the delay measurement. |
MEASUREMENT:MEAS1:DELAY:EDGE1 RISE MEASUREMENT:MEAS1:DELAY:EDGE1?
Sets or queries the slope of the edge used for the delay from or to waveform when taking an immediate delay measurement. The waveform is specified by MEASUrement:MEAS<x>:SOURCE[1].
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which waveform to use; 1 is the "from" waveform and 2 is the "to" waveform. |
MEASUREMENT:MEAS1:DELAY:EDGE1 RISE MEASUREMENT:MEAS1:DELAY:EDGE1? returns either RISE or FALL
Returns the delay measurement parameters for the measurement specified by <x>, where <x> ranges from 1 through 6. Query only.
MEASUrement:MEAS1:DELay? might return :MEASUREMENT:MEAS1:DELAY:DIRECTION FORWARDS;EDGE1 RISE;EDGE2 RISE.
Sets or queries the source for all single source measurements, and specifies the source to measure from for delay or phase measurements. This is equivalent to selecting the measurement source in the MEASURE menu.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH<x> | MATH | Measurement source to use. |
MEASUREMENT:MEAS2:SOURCE1 CH1 sets source1 for Measurement 2 to channel 1. MEASUrement:MEAS1:SOUrce1? might return MATH indicating the source for measurement 1 is the math waveform.
Sets or queries the source for single source measurements and, for delay or phase measurements, the source to measure from. It is equivalent to selecting the measurement source in the MEASURE menu.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH<x> | MATH | Measurement source channel. |
MEASUREMENT:MEAS2:SOURCE1 CH1 sets source1 for Measurement 2 to channel 1. MEASUrement:MEAS1:SOUrce1? might return MATH indicating the source for measurement 1 is the math waveform.
Sets or queries whether the specified measurement slot is computed and displayed. The measurement slot is specified by <x>, which ranges from 1 through 6.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | <NR1> | Enables or disables calculation and display of the specified measurement slot. |
MEASUrement:MEAS2:STATE ON computes and displays the measurement defined as measurement 2. MEASUrement:MEAS1:STATE? might return :MEASUREMENT:MEAS1:STATE 0 indicating that measurement defined for measurement slot 1 is disabled.
Sets or queries whether the specified measurement slot is computed and displayed. The measurement slot is identified by <x>, which ranges from 1 through 6.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | <NR1> | Enables or disables calculation and display of the specified measurement slot. |
MEASUrement:MEAS2:STATE ON computes and displays the measurement defined as measurement 2. MEASUrement:MEAS1:STATE? might return :MEASUREMENT:MEAS1:STATE 0 indicating that measurement defined for measurement slot 1 is disabled.
Sets or queries the on-screen periodic instrument measurement type for the specified measurement slot. The measurement slot is identified by <x>, which ranges from 1 through 6 depending on the instrument model; setting anything other than NONE displays the MEASURE menu.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | - | Measurement type to assign to the selected measurement slot. |
Sets or queries the on-screen periodic instrument measurement type for the specified measurement slot. Setting the type to anything other than NONE displays the MEASURE menu on the screen.
Returns the units for the instrument measurement specified by :MEASUrement:MEAS<x>:TYPe. <x> identifies the measurement number, 1 through 6.
Returns the value calculated for the specified on-screen periodic measurement. <x> identifies the measurement, 1 through 6; this is a query-only command and returns the same value shown on-screen.
MEASUREMENT:MEAS3:VALUE? might return 28.75E6 if measurement number three is frequency.
Sets or returns the low reference level. When MEASUrement:REFLevel:METHod is set to Absolute, this is the lower reference level.
| Name | Type | Values | Description |
|---|---|---|---|
| low reference level | real | V | The low reference level in volts. |
MEASUREMENT:REFLEVEL:ABSOLUTE:LOW <NR3> MEASUREMENT:REFLEVEL:ABSOLUTE:LOW?
Sets or returns the low reference level. When MEASUrement:REFLevel:METHod is set to Absolute, this is the lower reference level.
MEASUrement:REFLevel:ABSolute:LOW <NR3> MEASUrement:REFLevel:ABSolute:LOW?
Returns the current reference level parameters. Query only.
MEASUREMENT:REFLEVEL? might return these reference level settings PERCENT;ABSOLUTE:HIGH 0.0000;LOW 0.0000;MID1 0.0000;MID2 0.0000;:MEASUREMENT:REFLEVEL:PERCENT:HIGH 90.0000;LOW 10.0000;MID1 50.0000; MID2 50.0000
Sets or returns the mid reference level, which is the 50% reference level when MEASUrement:REFLevel:METHod is set to Absolute. This command affects period, frequency, delay, and cyclic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| mid1 | real | V | Mid reference level. |
MEASUREMENT:REFLEVEL:ABSOLUTE:MID 1.71 MEASUREMENT:REFLEVEL:ABSOLUTE:MID? might return 0.7100E+00 indicating that the absolute mid1 reference level is set to 0.71 V.
Sets or returns the mid reference level, which is the 50% reference level when MEASUrement:REFLevel:METHod is set to Absolute. It affects period, frequency, delay, and other cyclic measurement results.
MEASUREMENT:REFLEVEL:ABSOLUTE:MID 1.71 MEASUREMENT:REFLEVEL:ABSOLUTE:MID?
Sets or returns the reference level units used for measurement calculations. This affects the associated reference level parameter for all MEASurements:IMMed and the eight periodic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ABSolute | PERCent | Selects whether reference levels are set explicitly or calculated as a percent relative to HIGH and LOW. |
MEASUREMENT:REFLEVEL:METHOD ABSOLUTE specifies that explicit user-defined values are used for the reference levels. MEASUREMENT:REFLEVEL:METHOD? might return PERCENT indicating that the reference level units used are calculated as a percent relative to HIGH and LOW.
Sets or returns the reference level units used for measurement calculations. This command affects the associated reference level parameter for all immediate and periodic measurements.
MEASUREMENT:REFLEVEL:METHOD ABSOLUTE MEASUREMENT:REFLEVEL:METHOD? might return PERCENT
Sets or returns the percent used to calculate the high reference level when reference levels are configured as percent of HIGH and LOW. This command affects rise and fall measurement results.
Sets or returns the percent value used to calculate the high reference level when reference levels are in Percent mode. The percent is defined relative to HIGH and affects rise and fall measurements.
Sets or returns the percent (where 100% is equal to HIGH) used to calculate the low reference level when MEASUrement:REFLevel:METHod is set to Percent. This command affects the results of rise and fall measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 0 - 100 | The low reference level. |
MEASUrement:REFLevel:PERCent:LOW 15 sets the high reference level to 15% of HIGH. MEASUrement:REFLevel:PERCent:LOW?
Sets or returns the percent of HIGH used to calculate the low reference level when MEASUrement:REFLevel:METHod is set to Percent. It affects rise and fall measurements and the associated reference level parameter for MEASurements:IMMed and the four periodic measurements.
MEASUrement:REFLevel:PERCent:LOW 15 MEASUrement:REFLevel:PERCent:LOW?
Sets or returns the percent of HIGH used to calculate the mid reference level when MEASUrement:REFLevel:METHod is set to Percent. This command affects period, frequency, delay, and cyclic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| mid | real | 0 - 100 | Mid reference level percentage used to calculate the mid reference level. |
MEASUrement:REFLevel:PERCent:MID[1] 60 MEASUrement:REFLevel:PERCent:MID[1]?
Displays the measurement snapshot list on the instrument screen. Command only, no query form.
Sets or returns the snapshot source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH1 | CH2 | CH3 | CH4 | MATH | Snapshot source channel or math waveform. |
MEASUrement:SOURCESNAPShot CH1 sets the snapshot source to channel 1. MEASUrement:SOURCESNAPShot? might return CH1 indicating the snapshot source is channel 1.
Restores the factory-default instrument settings, user-saved settings from internal nonvolatile memory, or user-saved settings from a file on a USB flash drive. Using the FACTORY argument is equivalent to pushing the DEFAULT SETUP front-panel button.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FACtory | Selects the factory setup. |
| locationopt | integer | 1 - 10 | Specifies a setup memory storage location. |
| file pathopt | string | - | Path to a setup file on a USB flash drive. |
Recalls a saved waveform file to a reference memory location. Command only, with no query form.
| Name | Type | Values | Description |
|---|---|---|---|
| file path | string | - | Quoted string that defines the file name and path of the waveform file to recall. |
| ref | integer | 1 - 2 | Reference memory location in which to load the waveform. |
RECALL:WAVEFORM "tek00000.isf",REF1 recalls the waveform stored in the file named tek00000.isf from the current directory for waveforms to the reference location 1.
Returns reference waveform data for the channel specified by x, where x is the reference channel number. Query only.
Returns the date that reference waveform data for channel <x> was copied into the internal reference memory. Query only.
REF1:DATE? might return the date the reference waveform data for reference channel 1 was created.
Returns the horizontal delay time for reference waveform <x>, where x is the reference channel number. Query only.
Returns the time that reference waveform data was copied into the internal reference memory for reference channel <x>. Query only.
REF2:TIMe? might return “16:54:05”.
Returns the horizontal scale for reference waveform <x>, where x is the reference channel number. Query only.
REF<x>:HORizontal:SCAle? might return :REF1:HORIZONTAL:SCALE 4.0E-4.
Returns the vertical position for channel <x>, where x is the reference channel number. Query only.
REF2:POSition? might return the vertical position for reference 2.
Returns the vertical position of the reference waveform specified by <x>, where x is the reference channel number. Query only.
Returns the vertical scale for the reference waveform specified by <x>, where x is the reference channel number. Query only.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 | Reference channel number for the reference waveform to query. |
REF2:VERTICAL:SCALE?
Sets or queries the assignment of the data to be saved when the front-panel Save button is pressed.
SAVe:ASSIgn:TYPe WAVEform sets the data to be saved to waveform.
Sets or queries the assignment of the data to be saved when the front-panel Save button is pressed.
SAVe:ASSIgn:TYPe WAVEform sets the data to be saved to waveform.
Sets or queries the file format used for saving screen images when the file type cannot be determined from the file name or when images are captured from the front panel.
Saves the screen image to a file. The file format is determined by the current :SAVe:IMAge:FILEFormat setting, and the path may be omitted to save in the current working folder.
| Name | Type | Values | Description |
|---|---|---|---|
| file path | string | - | Quoted string defining the path and name of the screen image file to save. |
SAVe:IMAge " usb0\PROD-TST\VID-EVAL.BMP"
Sets or queries the file format used for saving screen images when the format cannot be determined from the file name or when images are captured from the front panel.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | PNG | BMP | JPG | File format to use for saved screen images. |
Sets or returns the layout used for saved screen images. Landscape saves the image in landscape format; portrait saves it in portrait format.
| Name | Type | Values | Description |
|---|---|---|---|
| layout | enum | LANdscape | PORTRait | Specifies the screen image layout to use when saving. |
SAVe:IMAGe:LAYout LANdscape SAVe:IMAGe:LAYout?
Sets or returns the layout used for saved screen images.
SAVe:IMAGe:LAYout LANdscape SAVe:IMAGe:LAYout?
Saves the current state of the instrument into the specified memory location. This is equivalent to the Save Setup menu option and can later be restored with *RCL.
| Name | Type | Values | Description |
|---|---|---|---|
| file path | string | - | Target location for storing the setup file, given as a quoted file name and path. |
| NR1 | integer | 1 - 10 | Front-panel setup location to save the current state. |
Stores a waveform in a nonvolatile reference memory location or saves it to a file, depending on the argument form. Only individual analog waveforms can be saved to reference memory locations.
| Name | Type | Values | Description |
|---|---|---|---|
| wfmopt | enum | CH<x> | MATH | FFT | Specifies the live waveform to save to reference memory or to a file. |
| refopt | enum | REF<x> | Specifies the reference memory location for saving a waveform. |
| QStringopt | string | - | Quoted string giving the path and name of the waveform file to save. |
SAVE:WAVEFORM CH1,REF1 :SAVE:WAVEFORM:FILEFORMAT SPREADSHEET; :SAVE:WAVEFORM Ch1, "usb0/test1_ch1.csv" :SAVe:WAVEform:FILEFormat INTERNal; :SAVe:WAVEform Ch1, "usb0/test1_ch1.isf"
Specifies or queries the file format for saved waveforms. Waveform header and timing information is included in the resulting file of non-internal formats.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | INTERNal | SPREADSheet | File format used when saving waveforms. |
SAVE:WAVEFORM:FILEFORMAT INTERNAL SAVE:WAVEFORM:FILEFORMAT?
Specifies or queries the file format for saved waveforms. Waveform header and timing information is included in the resulting file of non-internal formats.
SAVE:WAVEFORM:FILEFORMAT INTERNAL SAVE:WAVEFORM:FILEFORMAT? might return :SAVE:WAVEFORM:FILEFORMAT INTERNAL indicating that waveforms are saved using the internal format.
Turns the display of channel <x> waveform on or off and resets the acquisition. The query returns whether the channel is on or off, not whether it is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns the specified channel waveform display on or off. |
Turns the display of channel <x> waveform on or off and resets the acquisition. The query returns whether the channel is on or off, but does not indicate whether it is the selected waveform.
Sets or queries the waveform that receives future channel-related commands, such as cursor commands. The command form also performs the equivalent of a `SELect:CH<x> ON` command, as well as the Math, FFT and Reference of that command.
| Name | Type | Values | Description |
|---|---|---|---|
| waveform | enum | CH<x> | MATH | FFT | REF<x> | Specifies the waveform affected by the front-panel controls. |
SELect:CONTROl CH1 SELect:CONTROl?
Sets or queries the waveform that is the recipient of future channel-related commands, such as cursor commands. The command form also turns on the selected channel, math, FFT, or reference waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| waveform | enum | CH<x> | MATH | FFT | REF<x> | Specifies the waveform affected by the front-panel controls. |
SELect:CONTROl CH1 sets channel 1 as the recipient of future channel related commands. SELect:CONTROl? might return :SELect:CONTROl CH1 indicating that channel 1 is the recipient of future channel related commands.
Turns on and off the display of the FFT waveform. The query returns whether the FFT waveform is on or off, but does not indicate whether it is the selected waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns the FFT waveform display on or off. |
Turns on or off the display of the specified math waveform. The query returns whether the math waveform is on or off, and the selected waveform state is also affected by the setting.
SELECT:FFT ON turns the math waveform display on, and selects it. SELECT:FFT? might return :SELECT:FFT 1 indicating that the math waveform is being displayed.
Turns on and off the display of the math waveform. The query returns whether the math waveform is on or off but does not indicate whether it is the selected waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns the math waveform display on or off, or uses a numeric value where 0 turns it off and any other value turns it on. |
SELECT:MATH ON turns the math waveform display on, and selects it. SELECT:MATH? might return :SELECT:MATH 1 indicating that the math waveform is being displayed.
Turns on and off the display of the math waveform. The query returns whether the math waveform is on or off but does not indicate whether it is the selected waveform.
SELECT:MATH ON turns the math waveform display on, and selects it. SELECT:MATH? might return :SELECT:MATH 1 indicating that the math waveform is being displayed.
Turns on and off the display of reference waveform <x>. The <x> variable represents the reference channel number.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the specified reference waveform display on or off. |
| value | integer | - | <NR1> value used to control whether the specified reference waveform is displayed. |
Turns the display of the specified reference waveform on or off, and can also make that waveform the selected waveform. For queries, returns whether the specified reference waveform is displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the specified waveform display on or off. |
| value | integer | 0 | Any nonzero value turns the specified waveform on; 0 turns it off. |
SELECT:REF2 ON displays reference 2 and makes reference 2 the selected waveform. SELECT:REF2? might return :SELECT:REF2 1 indicating that reference waveform 2 is being displayed.
Returns most instrument settings. This query is identical to the *LRN? query and always returns command headers regardless of the HEADer setting.
SET? might return a partial string like the following: ACQUIRE:STOPAFTER RUNSTOP;STATE 1;MODE SAMPLE; NUMAVG 16;:HEADER 1;:VERBOSE 1;:DISPLAY:FORMAT YT;STYLE VECTORS;PERSISTENCE 500.0E-3;CONTRAST 50;:LOCK NONE;:HARDCOPY:FORMAT EPSON;PORT RS232;LAYOUT PORTRAIT;
Returns the date when the instrument setup was saved for the specified setup<x>. Query only.
Returns the time when the instrument setup was saved for the specified setup<x>.
SETUP2:TIME? might return :SETUP2:TIME: 15:24:07 which is the setup time for channel 2.
Sets the Teksecure Erase Memory option to erase user data, including settings or confidential data files. The instrument is inoperable until the TekSecure operation is complete.
Sets or queries the time the instrument displays. The instrument uses the time value to time stamp files and show the time and date on the display.
| Name | Type | Values | Description |
|---|---|---|---|
| time | string | - | Time in the form "hh:mm:ss". |
TIME "14:00:00" TIME?
Sets or queries the time the instrument displays. The instrument uses the time and date values to time stamp files and show the time and date on the instrument display.
| Name | Type | Values | Description |
|---|---|---|---|
| time | string | - | Time in the form "hh:mm:ss". |
TIME "14:00:00" TIME? might return :TIME "11:25:03"
Forces a trigger event to occur. If TRIGger:STATE is Ready, acquisition completes; otherwise the command is ignored.
| Name | Type | Values | Description |
|---|---|---|---|
| FORCe | - | - | Creates a trigger event. |
TRIGger FORCE forces a trigger event to occur.
Sets the instrument trigger level to 50% of the minimum and maximum values of the signal. When used as a query, it returns the current A trigger settings.
TRIGger:A SETLEVEL TRIGGER:A?
Returns the current A trigger settings. The level can be set to 50% of the minimum and maximum values of the trigger source input signal.
TRIGger:A?
Sets the type of coupling for the A edge trigger. This is equivalent to setting the Coupling option in the Trigger menu.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | DC | HFRej | LFRej | NOISErej | Type of coupling for the A edge trigger. |
Sets or queries the type of coupling for the A edge trigger. This is equivalent to setting the Coupling option in the Trigger menu.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DC | HFRej | LFRej | NOISErej | Trigger coupling type. |
TRIGger:A:EDGE:COUPling?
Returns the trigger coupling, source, and slope settings for the A edge trigger. Query only.
TRIGger:A:EDGE? might return :TRIGGER:A:EDGE:SOURCE CH1;COUPLING DC; SLOPE RISE indicating the trigger source, coupling, and slope for the A edge trigger.
Sets or queries the slope for the A edge trigger. This is equivalent to setting the Slope option in the Trigger menu.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | RISe | FALL | Selects whether to trigger on the rising or falling edge of the signal. |
TRIGger:A:EDGE:SLOpe RISE sets the A edge trigger to occur on the rising edge of the signal. TRIGGER:A:EDGE:SLOPE? might return :TRIGGER:A:EDGE:SLOPE FALL indicating that the A edge trigger slope is negative.
Sets or queries the slope for the A edge trigger. This is equivalent to setting the Slope option in the Trigger menu.
TRIGger:A:EDGE:SLOpe RISE TRIGGER:A:EDGE:SLOPE?
Sets or queries the source for the A edge trigger. This is equivalent to setting the Source option in the Trigger menu.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH1 | CH2 | LINE | AUX | Edge trigger source. |
Sets or queries the source for the A edge trigger. This is equivalent to setting the Source option in the Trigger menu.
Sets the A trigger holdoff time. The related query returns the A trigger holdoff value, which is the time period during which the trigger circuitry is not looking to generate a trigger event.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | 0 - ∞ | A trigger holdoff time. |
Returns the A trigger holdoff parameters, which specify the time period during which the trigger circuitry is not looking to generate a trigger event. Query only.
TRIGger:A:HOLDOff? might return :TRIGGER:A:HOLDOFF:TIME 900.0000E-09, indicating that the A edge trigger holdoff time (by default) is 900 ns.
Sets or queries the A trigger holdoff time. The range is 20 ns to 8.0 s.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | 20 ns - 8.0 s | A trigger holdoff time. |
TRIGger:A:HOLDOff:TIMe 10 TRIGGER:A:HOLDOFF:TIME?
Sets or queries the trigger level for the A trigger. This command is equivalent to adjusting the front-panel TRIGGER LEVEL knob; when the edge trigger source is AC LINE, the set form is ignored and the query returns zero.
| Name | Type | Values | Description |
|---|---|---|---|
| level | enum | ECL | TTL | Preset trigger level selection. |
| level | real | V | Trigger level in user units, usually volts. |
TRIGGER:A:LEVEL TTL TRIGger:A:LEVel?
Sets or queries the trigger level for the A trigger. When the edge trigger source is set to AC LINE, the set form is ignored and the query form returns zero.
TRIGGER:A:LEVEL TTL TRIGger:A:LEVel? might return :TRIGGER:A:LEVel 1.3000E+00
Sets or queries the trigger level for channel <x>. The level can be specified as a numeric value in user units or as preset TTL/ECL high levels.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | Trigger level in user units, usually volts. |
| state | enum | TTL | ECL | Preset trigger level keyword. |
TRIGGER:A:LEVEL: CH1 TTL sets the A edge trigger to TTL high level for channel 1. TRIGGER:A:LEVEL:CH2? might return :TRIGGER:A:LEVEL:CH2 1.3000E+00 indicating that the A edge trigger is set to 1.3 V for channel 2.
Sets or queries the trigger A level for channel x. The level can be specified as a numeric value in user units or as a preset TTL/ECL high level.
| Name | Type | Values | Description |
|---|---|---|---|
| channel x | integer | - | Channel selector x. |
| level | real | V | Trigger level in user units, usually volts. |
| qualifier | enum | TTL | ECL | Preset trigger level keyword. |
TRIGGER:A:LEVEL:CH1 TTL sets the A edge trigger to TTL high level for channel 1. TRIGGER:A:LEVEL:CH2? might return :TRIGGER:A:LEVEL:CH2 1.3000E+00 indicating that the A edge trigger is set to 1.3 V for channel 2.
Sets or queries the lower threshold for the selected channel. Each channel can have an independent level; it is used as the lower threshold in Runt trigger mode and as the single level/threshold for other trigger types.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | - | - | Channel index x in CH<x>. |
| mode | enum | ECL | TTL | Preset threshold level keyword. |
| value | real | V | Threshold level in volts. |
TRIGGER:A:LOWERTHRESHOLD:CH2 50E-3 TRIGGER:A:LOWERTHRESHOLD:CH2?
Sets or queries the lower threshold for the selected channel. Each channel can have an independent level, used as the lower threshold in Runt trigger and as the single level/threshold for other trigger types.
TRIGGER:A:LOWERTHRESHOLD:CH2 50E-3 TRIGGER:A:LOWERTHRESHOLD:CH2?
Sets or queries the trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AUTO | NORMal | Trigger mode to use. |
TRIGger:A:MODe NORMAL specifies that a valid trigger event must occur before a trigger is generated. TRIGGER:A:MODE ? might return :TRIGGER:A:MODE NORMAL indicating that a valid trigger event must occur before a trigger is generated.
Sets or queries the trigger mode.
TRIGger:A:MODe NORMAL specifies that a valid trigger event must occur before a trigger is generated. TRIGGER:A:MODE ? might return :TRIGGER:A:MODE NORMAL indicating that a valid trigger event must occur before a trigger is generated.
Returns the current Pulse Trigger settings. Query only.
TRIGger:A:PULse? might return :TRIGGER:A:PULSE:CLASS TRAnsITION.
Queries the width for the pulse-width trigger. Query only.
Sets or queries the type of pulse used for A trigger. RUNt triggers when a pulse crosses the first preset voltage threshold but not the second before recrossing the first; WIDth triggers on a pulse of the specified polarity within the specified time limits.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | RUNt | WIDth | Selects the pulse class used for triggering. |
TRIGGER:A:PULSE:CLASS WIDTH TRIGGER:A:PULSE:CLASS?
Sets or queries the type of pulse on which to trigger.
TRIGGER:A:PULSE:CLASS WIDTH TRIGGER:A:PULSE:CLASS? might return :TRIGGER:A:PULSE:CLASS WIDTH indicating that a pulse was found that is of the specified polarity and width.
Sets or queries the polarity for the pulse width trigger. This is equivalent to setting the Polarity option in the Pulse Trigger menu.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | NEGative | POSitive | Selects whether pulse triggers use a rising or falling leading edge. |
TRIGGER:A:PULSEWIDTH:POLARITY NEGATIVE sets the pulse polarity to negative. TRIGGER:A:PULSEWIDTH:POLARITY? might return :TRIGGER:A:WIDTH:POLARITY POSITIVE indicating a positive pulse.
Sets or queries the polarity for the pulse width trigger. This is equivalent to setting the Polarity option in the Pulse Trigger menu.
TRIGGER:A:PULSEWIDTH:POLARITY NEGATIVE TRIGGER:A:PULSEWIDTH:POLARITY? might return :TRIGGER:A:WIDTH:POLARITY POSITIVE
Sets or queries the source for the pulse width trigger. This is equivalent to setting the Source option in the Trigger menu.
Sets or queries the source for the pulse width trigger. This is equivalent to setting the Source option in the Trigger menu.
TRIGGER:A:PULSEWIDTH:SOURCE CH1 sets channel 1 as the pulse width source. TRIGGER:A:PULSEWIDTH:SOURCE? might return :TRIGGER:A:PULSEWIDTH:SOURCE CH1 indicating that channel 1 is the pulse width source.
Sets or queries whether to trigger on a pulse that meets, falls outside, or is within the specified width range limits. This is equivalent to the When option in the Pulse Trigger menu.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | LESSthan | MOREthan | EQual | UNEQual | Selects the pulse-width trigger condition. |
TRIGGER:A:PULSEWIDTH:WHEN LESSTHAN specifies that the duration of the A pulse will fall within defined high and low limits. TRIGGER:A:PULSEWIDTH:WHEN? might return :TRIGGER:A:PULSEWIDTH:WHEN LESSTHAN indicating that the conditions for generating a width trigger.
Sets or queries whether to trigger on a pulse that meets, falls outside, or is within the specified range of limits. This is equivalent to setting the When option in the Pulse Trigger menu.
TRIGGER:A:PULSEWIDTH:WHEN LESSTHAN specifies that the duration of the A pulse will fall within defined high and low limits. TRIGGER:A:PULSEWIDTH:WHEN? might return :TRIGGER:A:PULSEWIDTH:WHEN LESSTHAN indicating that the conditions for generating a width trigger.
Sets or queries the width setting for the pulse width trigger. This is equivalent to setting the Width option by using the Pulse Trigger menu and the TRIGGER knob.
| Name | Type | Values | Description |
|---|---|---|---|
| width | real | - | Pulse width trigger threshold value. |
Sets or queries the pulse width value used by the pulse width trigger. This is equivalent to setting the Width option in the Pulse Trigger menu and with the TRIGGER knob.
Sets or queries the polarity for the runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | NEGative | POSitive | Selects the runt trigger polarity. |
Sets or queries the polarity for the runt trigger.
TRIGGER:A:RUNT:POLarity?
Returns the current A runt trigger parameters. Query only.
TRIGGER:A:RUNT? might return :TRIGGER:A:RUNT:SOURCE CH1;POLARITY POSITIVE;WHEN OCCURS;WIDTH 4.0000E-9.
Sets or queries the source for the A runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH1 | CH2 | Specifies the analog input channel used as the trigger source. |
TRIGGER:A:RUNT:SOURCE CH1 TRIGGER:A:RUNT:SOURCE?
Sets or queries the source for the A runt trigger.
TRIGGER:A:RUNT:SOURCE CH1 TRIGGER:A:RUNT:SOURCE?
Sets or queries the type of pulse width the trigger checks for when it detects a runt.
Sets or queries the type of pulse width the trigger checks for when it detects a runt.
TRIGger:A:RUNT:WHEn {LESSthan|MOREthan|EQual|UNEQual|OCCURS}
TRIGger:A:RUNT:WHEn?Sets or queries the width for a runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| width | real | s | Minimum width for the runt trigger. |
TRIGGER:A:RUNT:WIDTH 15E-6 TRIGGER:A:RUNT:WIDTH?
Sets or queries the width for a runt trigger. The argument specifies the minimum width in seconds.
TRIGGER:A:RUNT:WIDTH 15E-6 TRIGGER:A:RUNT:WIDTH?
Sets or queries the type of A trigger. This is equivalent to setting the Type option in the Trigger menu.
Sets or queries the type of A trigger. This is equivalent to setting the Type option in the Trigger menu.
Sets or queries the upper threshold for channel <x>. Each channel can have an independent level and the setting is used only for runt trigger type.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | integer | - | Channel number <x>. |
| threshold | enum | <NR3> | ECL | TTL | Upper threshold level for the selected channel. |
TRIGGER:A:UPPERTHRESHOLD:CH2 50E-3 TRIGGER:A:UPPERTHRESHOLD:CH2?
Sets or queries the upper threshold for channel <x>. Each channel can have an independent level, and it is used only for runt trigger type.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | integer | - | Channel number <x>. |
| threshold | real | V | Threshold level for the channel. |
| levelopt | enum | ECL | TTL | Preset threshold level. |
TRIGGER:A:UPPERTHRESHOLD:CH2 50E-3 TRIGGER:A:UPPERTHRESHOLD:CH2?
Returns the edge or pulse width trigger frequency, the same value shown in the lower-right corner of the screen. Query only.
TRIGger:FREQuency? might return TRIGGER:FREQUENCY 1.0E3.
Returns the current state of the triggering system. Query only.
Unlocks the front panel. This command is equivalent to LOCk NONe and has no query form.
| Name | Type | Values | Description |
|---|---|---|---|
| ALL | enum | ALL | Specifies all front-panel buttons. |
UNLock ALL unlocks all front-panel buttons and knobs so they can be used.
Sets and queries the Verbose state that controls the length of keywords on query responses. It does not affect IEEE Std 488.2-1987 Common Commands.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Sets the Verbose state true or false. |
VERBose ON VERBose? might return the value 1, showing that the Verbose state is true.
Sets and queries the Verbose state that controls the length of keywords on query responses. It affects both headers and arguments, but does not affect IEEE Std 488.2-1987 Common Commands.
VERBose? might return the value 1, showing that the Verbose state is true.
Returns WFMOutpre? and CURVe? data for the waveform specified by :DATA:SOUrce. The source waveform must be active or the query will not return data and will generate an error indicator.
Sets or returns the number of bits per binary waveform point for the incoming waveform. Changing WFMInpre:BIT_Nr also changes WFMInpre:BYT_Nr.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | enum | 8 | 16 | Number of bits per binary waveform point. |
WFMINPRE:BIT_NR 16 WFMINPRE:BIT_NR?
Sets or returns the number of bits per binary waveform point for the incoming waveform. Changing WFMInpre:BIT_Nr also changes WFMInpre:BYT_Nr.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR1> | integer | 8 - 16 | Number of bits per binary waveform point. |
WFMINPRE:BIT_NR 16 WFMINPRE:BIT_NR?
Returns the waveform formatting and scaling specifications to be applied to the next incoming CURVe command data. Query only.
Sets or queries the data width for the incoming waveform. Changing WFMInpre:BYT_Nr also changes WFMInpre:BIT_Nr.
| Name | Type | Values | Description |
|---|---|---|---|
| nr1 | integer | 1 - 2 | Number of bytes per point. |
WFMINPRE:BYT_NR 1 WFMINPRE:BYT_NR?
Sets or queries the data width for the incoming waveform. Changing WFMInpre:BYT_Nr also changes WFMInpre:BIT_Nr.
WFMINPRE:BYT_NR 1 WFMINPRE:BYT_NR? might return :WFMINPRE:BYT_NR 2
Sets or queries the type of encoding for waveform data transferred with the CURVe command.
| Name | Type | Values | Description |
|---|---|---|---|
| encoding | enum | ASCii | BINary | Selects the waveform data encoding format. |
WFMINPre:ENCdg ASC specifies that the waveform data is in ASCII format. WFMINPre:ENCdg? might return :WFMINPRE:ENCDG BIN, indicating that the waveform data is in binary format.
Sets or queries the type of encoding for waveform data transferred with the CURVe command.
WFMINPre:ENCdg ASC specifies that the waveform data is in ASCII format. WFMINPre:ENCdg? might return :WFMINPRE:ENCDG BIN, indicating that the waveform data is in binary format.
Sets or queries the number of points expected in the incoming waveform record. The value is the number of data points when WFMInpre:PT_Fmt is Y, or the number of min-max pairs when WFMInpre:PT_Fmt is ENV.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | - | Number of data points, or min-max pairs when PT_Fmt is ENV. |
WFMINPRE:NR_PT 10000 specifies that that 10000 data points will be expected. WFMINPRE:NR_PT ? might return :WFMINPRE:NR_PT 2000 indicating that there are 2000 data points in the expected incoming waveform record.
Returns the number of points that are in the incoming waveform record.
Sets or queries the horizontal interval between incoming waveform points in units specified by WFMInpre:XUNit.
| Name | Type | Values | Description |
|---|---|---|---|
| interval | real | - | Interval between points in the waveform record, in the units specified by WFMPre:XUNit. |
Sets or queries the horizontal interval between incoming waveform points in units specified by WFMInpre:XUNit.
| Name | Type | Values | Description |
|---|---|---|---|
| interval | real | - | Interval between points in the waveform record, in the units specified by WFMPre:XUNit. |
WFMINPRE:XINCR 3E-3 WFMINPRE:XINCR ?
Sets or queries the horizontal units of the incoming waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| Qstring | string | - | Maximum of three alpha characters that represent the horizontal unit of measure for the incoming waveform. |
WFMINPRE:XUNIT "HZ" WFMINPRE:XUNIT?
Sets or queries the horizontal units of the incoming waveform. The argument is a quoted string containing up to three alphabetic characters that represent the horizontal unit of measure.
WFMINPRE:XUNIT "HZ" specifies that the horizontal units for the incoming waveform are hertz. WFMINPRE:XUNIT? might return :WFMINPRE:XUNIT "s" indicating that the horizontal units for the incoming waveform are seconds.
Sets or queries the position value, in XUNits, of the first sample of the incoming waveform relative to the trigger. The instrument sets WFMPre:XZEro to zero in XY display mode or when DATa:SOUrce is MATH FFT during waveform acquisition.
Returns the X position of the first sample in the incoming waveform, in X units. If XUnits is seconds, the value is the time of the first sample in the incoming waveform.
WFMINPRE:XZERO? might return :WFMINPRE:XZEro -7.5000E-6 indicating that the trigger occurs 7.5 μs after the first sample in the waveform.
Sets or queries the vertical scale factor of the incoming waveform, expressed in YUNits per waveform data point level. YMUlt, YOFf, and YZEro are used to convert waveform record values to YUNit values.
| Name | Type | Values | Description |
|---|---|---|---|
| scale factor | real | - | Vertical scale factor per digitizing level of the incoming waveform points. |
WFMInpre:YMULT? might return :WFMINPRE:YMULT 40.0000E-3, which (if YUNit is "V") indicates that the vertical scale is 40 mV/digitizing level (1V/div for 8-bit data).
Sets or queries the vertical scale factor of the incoming waveform, expressed in YUNits per waveform data point level. It is used with YOFf and YZEro to convert waveform record values to YUNit values.
WFMINPRE:YMULT? might return :WFMINPRE:YMULT 40.0000E-3, which (if YUNit is "V") indicates that the vertical scale is 40 mV/digitizing level (1V/div for 8-bit data).
Sets the vertical position of the incoming waveform in digitizing levels. Variations in this number are analogous to changing the vertical position of the waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | - | The vertical position of the incoming waveform in digitizing levels. |
Returns the vertical units of the incoming waveform.
WFMINPRE:YUNIT? might return :WFMINPRE:YUNIT "V" indicating that the vertical units for the incoming waveform are volts.
Sets or returns the vertical units of the incoming waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| Qstring | string | - | Contains a maximum of three alpha characters that represent the vertical unit of measure for the incoming waveform. |
WFMINPRE:YUNIT "A" specifies that the vertical units for the incoming waveform are Amperes. WFMINPRE:YUNIT? might return :WFMINPRE:YUNIT "V" indicating that the vertical units for the incoming waveform are volts.
Sets or returns the vertical units of the incoming waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| Qstring | string | - | Contains a maximum of three alpha characters that represent the vertical unit of measure for the incoming waveform. |
WFMINPRE:YUNIT "A" specifies that the vertical units for the incoming waveform are Amperes. WFMINPRE:YUNIT? might return :WFMINPRE:YUNIT "V" indicating that the vertical units for the incoming waveform are volts.
Sets or returns the vertical offset of the incoming waveform in units specified by WFMInpre:YUNit. Variations in this number are analogous to changing the vertical offset of the waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Offset expressed in YUNits. |
Sets or returns the vertical offset of the incoming waveform in units specified by WFMInpre:YUNit. Variations in this number are analogous to changing the vertical offset of the waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | YUNits | Offset expressed in YUNits. |
WFMINPRE:YZERO 1.5E+0 WFMINPRE:YZERO?
Returns waveform transmission and formatting settings for the waveform specified by the DATa:SOUrce command. If the selected waveform is not displayed, only the waveform transmission parameters are returned.
WFMOUTPRE? might return the waveform formatting data as: :WFMOUTPRE:BYT_NR 2;BIT_NR 16;ENCDG ASCII;BN_FMT RI;BYT_ORMSB;WFID "Ch1, DC coupling, 100.0mV/div, 4.000us/div, 10000 points, Sample mode";NR_PT 2000;PT_FMT Y;XUNIT "s";XINCR 4.0000E-9;XZERO - 20.0000E-6;PT_OFF 0;YUNIT "V";YMULT 15.6250E-6;YOFF :"6.4000E+3;YZERO 0.0000.
Sets and queries the number of bits per waveform point used by outgoing waveforms specified by DATa:SOUrce. Changing this value also changes WFMInpre:FILTERFreq and DATa:WIDth.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 8 - 16 | Number of bits per data point. |
WFMOUTPRE:BIT_NR 16 WFMOUTPRE:BIT_NR?
Queries the number of bits per waveform point used by outgoing waveforms, as specified by DATa:SOUrce. Changing WFMOutpre:BIT_Nr also changes WFMInpre:FILTERFreq and DATa:WIDth.
WFMOUTPRE:BIT_NR? might return :WFMOUTPRE:BIT_NR 8 indicating that outgoing waveforms use 8 bits per waveform point.
Sets or returns the format of binary data for outgoing waveforms specified by the DATa:SOUrce command. Changing the value of WFMOutpre:BN_Fmt also changes the value of DATa:ENCdg.
WFMOUTPRE:BN_FMT RP specifies that outgoing waveform data will be in positive integer format.
Sets or returns the format of binary data for outgoing waveforms specified by the DATa:SOUrce command. Changing the value also changes the value of DATa:ENCdg.
WFMOUTPRE:BN_FMT RP specifies that outgoing waveform data will be in positive integer format.
Sets or queries the data width for the outgoing waveform specified by the DATa:SOUrce command. Changing this setting also changes WFMOutpre:BIT_Nr and DATa:WIDth.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR1> | integer | 1 - 2 | Number of bytes per data point. |
WFMOUTPRE:BYT_NR 1 WFMOUTPRE:BYT_NR?
Sets or queries the data width for the outgoing waveform specified by the DATa:SOUrce command. Changing WFMOutpre:BYT_Nr also changes WFMOutpre:BIT_Nr and DATa:WIDth.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 1 - 2 | Number of bytes per data point. |
WFMOUTPRE:BYT_NR 1 WFMOUTPRE:BYT_NR?
Sets or queries the type of encoding for outgoing waveforms.
Sets and queries the type of encoding for outgoing waveforms.
Returns the number of points for the DATa:SOUrce waveform that will be transmitted in response to a CURVe? query. The query will timeout and an error will be generated if the waveform specified by DATa:SOUrce is not turned on.
WFMOUTPRE:NR_PT? might return :WFMOUTPRE:NR_PT 2000 indicating that there are 2000 data points to be sent.
Returns the record length for the source waveform as specified by the DATa:SOUrce command. Query only.
WFMOUTPRE:RECORDLENGTH? might return :WFMOUTPRE:RECORDLENGTH 2000 indicating that 2000 is the source waveform record length.
Returns a string describing several aspects of the acquisition parameters for the waveform specified by the DATa:SOUrce command. The query will time out and generate an error if the waveform specified by DATa:SOUrce is not turned on.
WFMOUTPRE:WFID? might return :WFMOUTPRE:WFID "Ch1, DC coupling,100.0mVolts/div,500.0μs/div, 1000 points, Sample mode".
Returns the horizontal point spacing in units of WFMOutpre:XUNit for the waveform specified by DATa:SOUrce. This value corresponds to the sampling interval.
Returns the horizontal units for the waveform specified by the DATa:SOUrce command. The query times out and generates an error if the waveform specified by DATa:SOUrce is not turned on.
WFMOUTPRE:XUNIT? might return :WFMOUTPRE:XUNIT "HZ" indicating that the horizontal units for the waveform are in Hertz.
Returns the time coordinate of the first point in the outgoing waveform. This value is expressed in the units returned by :WFMOutpre:XUNit?. Query only.
WFMOUTPRE:XZERO? might return :WFMOUTPRE:XZERO 5.6300E-9 indicating that the trigger occurred 5.63 ns before the first sample in the waveform record.
Returns the vertical scale factor per digitizing level, in the units specified by WFMOutpre:YUNit, for the waveform specified by DATa:SOUrce. The query times out and generates an error if the selected waveform is not turned on.
WFMOUTPRE:YMULT? might return :WFMOUTPRE:YMULT 4.0000E-3 indicating that the vertical scale for the corresponding waveform is 100 mV/div (for 8-bit waveform data).
Returns the vertical position in digitizing levels for the waveform specified by the DATa:SOUrce command. The query times out and an error is generated if the source waveform is not turned on.
WFMOUTPRE:YOFF? might return :WFMOUTPRE:YOFF -50.0000E+0 indicating that the position indicator for the waveform was 50 digitizing levels (2 divisions) below center screen (for 8-bit waveform data).
Returns the vertical units for the waveform specified by the DATa:SOUrce command. The query times out and generates an error if the specified waveform is not turned on.
WFMOUTPRE:YUNIT? might return :WFMOUTPRE:YUNIT "dB" indicating that the vertical units for the waveform are measured in decibels.
Returns the vertical offset for the waveform specified by the DATa:SOUrce command, expressed in the units returned by WFMOutpre:YUNit?. The query times out and generates an error if the selected waveform is not turned on.
WFMOUTPRE:YZERO? might return :WFMOUTPRE:YZERO -100.0000E-3 indicating that vertical offset is set to –100 mV.
Returns the current vertical and horizontal positioning and scaling of the display. Query only.
ZOOM? might return :ZOOM:MODE 1; :ZOOM:ZOOM1:STATE 1;SCALE 20.0000E-9;POSITION 50.0000; FACTOR 10.0000; HORIZONTAL:POSITION 50.0000;SCALE 20.0000E-9.
Queries the zoom factor of a particular zoom box. Query only.
ZOOM:ZOOM1:FACtor? might return :ZOOM:ZOOM1:FACtor X5 indicating that the specified zoom factor is X5 of the acquired waveform.
Sets or queries the horizontal position of a specified zoom box.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | real | - | Horizontal position value for the specified zoom box. |
Sets or queries the horizontal position of a specified zoom box.
Returns the current horizontal positioning and scaling of the display. Query only.
ZOOM:ZOOM1? might return :ZOOM:ZOOM1:STATE 1;SCALE 20.0000E-9;POSITION 50.0000;FACTOR 10.0000;HORIZONTAL:POSITION 50.0000;SCALE 20.0000E-9.
Sets or queries the zoom horizontal scale for the specified zoom.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 1.0E-9 - 100.0 | The amount of expansion in the horizontal direction. |
ZOOM:ZOOM1:HORIZONTAL:SCALE 5 sets the horizontal scale to 5 seconds per division. ZOOM:ZOOM2:HORIZONTAL:SCALE? might return :ZOOM2:HORIZONTAL:SCALE 1, indicating that the horizontal scale is 1 second per division.
Sets or queries the zoom horizontal scale for the specified zoom.
ZOOM:ZOOM1:HORIZONTAL:SCALE 5 ZOOM:ZOOM2:HORIZONTAL:SCALE?
Sets or queries the horizontal position for the specified zoom. The value is the percent of the upper window that is to the left of screen center when the zoom factor is 1× or greater.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | 0 - 100.00 | Percent of the upper window to the left of screen center. |
ZOOm:ZOOM1:POSition 50.00 ZOOm:ZOOM1:POSition?
Sets or queries the horizontal position for the specified zoom.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 0 - 100.00 | Percent of the upper window that is to the left of screen center when the zoom factor is 1× or greater. |
ZOOM:ZOOM1:POSition 50.00 ZOOM:ZOOM1:POSITION? might return :ZOOM1:POSITION 50.00, indicating the reference pointer is at 50% of the acquired waveform.
Sets or queries the specified zoom on or off. Zero disables the specified zoom; any other value enables it.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns the specified Zoom on or off, or enables/disables it with a numeric value. |
ZOOM:ZOOM1:STATE ON turns Zoom1 on.
Sets or queries the specified zoom on or off for zoom window 1. A zero value disables the zoom; any other numeric value enables it.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the specified Zoom on or off. |
| value | integer | 0 | An integer where 0 disables the specified zoom and any other value enables it. |
ZOOM:ZOOM1:STATE ON turns Zoom1 on.
Sets or queries the zoom horizontal scale for the specified zoom.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | 1.0E-9 - 100.0 | Amount of expansion in the horizontal direction. |
ZOOm:ZOOM1:SCAle 5.0 sets the horizontal expansion of the specified Zoom to 5. ZOOm:ZOOM1:SCAle? might return ZOOm:ZOOM1:SCAle 5.0 indicating the zoom1 horizontal expansion is set to 5.
Sets or queries the zoom horizontal scale for the specified zoom.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | 1.0E-9 - 100.0 | Amount of expansion in the horizontal direction. |
ZOOm:ZOOM1:SCAle 5.0 sets the horizontal expansion of the specified Zoom to 5. ZOOm:ZOOM1:SCAle? might return ZOOm:ZOOM1:SCAle 5.0 indicating the zoom1 horizontal expansion is set to 5.
Turns Zoom mode on or off. The query returns the current state of Zoom mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Zoom mode on or off. |
ZOOM:MODE OFF turns off Zoom mode. ZOOM:MODE? might return :ZOOM:MODE 1 indicating that Zoom mode is currently turned on.
Turns Zoom mode on or off. The query returns the current state of Zoom mode. This command is equivalent to pressing the zoom button on the front panel.
| Name | Type | Values | Description |
|---|---|---|---|
| mode/stateopt | enum | ON | OFF | <NR1> | Sets Zoom mode to on or off. |
ZOOM:MODE OFF turns off Zoom mode. ZOOM:MODE? might return :ZOOM:MODE 1 indicating that Zoom mode is currently turned on.
Reads the next event number from the Event Queue. Reading an event removes it from the queue and requires that the corresponding summary event has first been read with *ESR?.
Query whether the instrument is busy processing a command with extended processing time, such as single-sequence acquisition. It is used for synchronization as an alternative to *WAI or *OPC? loops.
Sets the immediate measurement type used by built-in measurements. The example shows it being set to MEAN and FREQ before querying the measured value.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | MEAN | FREQ | Measurement type to use for immediate measurement. |
MEASU:IMMED:TYPE MEAN MEASU:IMMED:TYPE FREQ
Returns the current value of the selected immediate measurement. In the example, it is used after setting `MEASU:IMMed:TYPE` to read the measured waveform value.
> MEASU:IMMED:VALUE? :MEASUREMENT:IMMED:VALUE 2.4631931782E0
Queries out the waveform preamble parameters used for calculating the times and voltages of waveform points.
:WFMPRE?
Recalls the instrument to the factory default setup. The manual shows the concatenated command FACtory;SET as the response for the factory setup listing, and notes that items in parentheses are returned by the SET? query response but are not changed by FACtory.