Returns the maximum real-time sample rate, which varies from model to model.
SCPI COMMAND REFERENCE
The Tektronix TBS2102B is Tektronix's oscilloscope in the TBS2000B family. Its SCPI remote-control interface exposes 407 commands across 56 subsystems - 229 settable and 178 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.
407
Commands
229
Settable
178
Queries
56
Subsystems
SCPI
Verified
2026-07-16
All commands
Sets or queries the acquisition mode for all live waveforms. The acquisition mode determines how the final value of each acquisition interval is generated from the sampled data.
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 starting instrument acquisition. The count continues to increase while acquisitions are running until a reset occurs.
Sets or queries the number of waveform acquisitions that make up an averaged waveform. Use ACQuire:MODe to enable Average mode.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 2 - 512 | Number of waveform acquisitions to average; values are 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. When state is set to ON or RUN, a new acquisition is started; if RUN is issued during a single-sequence acquisition, the sequence is restarted and accumulated data is discarded.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | RUN | Acquisition state to set. |
Sets or returns whether the instrument continually acquires acquisitions or acquires a single sequence.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | RUNSTop | SEQuence | Selects continuous acquisition or a single-sequence acquisition. |
ACQuire:STOPAfter `RUNSTOP ACQuire:STOPAfter?
Starts or stops acquisition state. The example shows it being set to ON to start a single-sequence acquisition.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Acquisition state. |
ACQUIRE:STATE ON
Sets what ends the acquisition. In the example, ACQUIRE:STOPAFTER SEQUENCE is used to start a single-sequence acquisition.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | RUNSTop | SEQuence | Acquisition stop condition. |
Sets the maximum sample rate for the acquisition system.
Sets or queries the state of alias functionality. Alias commands can define new commands as a sequence of standard commands, and alias mode must be turned on to use them.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | <NR1> | Turns alias expansion off or on, or disables/enables alias mode with a numeric value. |
ALIas {OFF|ON|<NR1>}
ALIas?Sets or queries the state of alias functionality. Alias commands define new commands as a sequence of standard commands; aliases are similar to macros but do not support parameter substitution.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | Turns alias expansion off or on. |
| value | integer | 0 | Disables alias mode when 0; any other value enables alias mode. |
ALIas ON ALIAS?
Returns a list of the currently defined alias labels, separated by commas. If no aliases are defined, the query returns an empty 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 definitions of a selected alias.
| Name | Type | Values | Description |
|---|---|---|---|
| label | string | - | Alias label; must not be a command name, must start with a letter, may contain only letters, numbers, and underscores, and must be 12 characters or less. |
| sequence | string | - | Complete sequence of program messages to assign to the alias; commands must be valid, separated by semicolons, and the sequence must be 256 characters or less. |
ALIAS:DEFINE "ST1",":RECALL:SETUP 5;:AUTOSET EXECUTE;:SELECT:CH1 ON" ALIAS:DEFINE? "ST1"
Removes a specified alias. It is identical to ALIas:DELEte:NAMe and generates an error if the named alias does not exist.
| Name | Type | Values | Description |
|---|---|---|---|
| QString | string | - | The alias label 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 ALIAS[:STATE]?
Returns all events and their messages from the Event Queue and removes the returned events. The messages are separated by commas.
Returns all event numbers with a description of each event. Reading an event removes it from the queue.
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 or restores the prior oscilloscope settings. |
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 | ON enables the autoset feature. OFF disables the autoset feature. |
AUTOSET:ENABLE OFF AUTOSET:ENABLE? might return 1 indicating that autoset is enabled.
Starts a signal path compensation. It is command only and has no query form.
CALibrate:INTERNAL starts a signal path compensation cycle.
Starts the internal signal path calibration (SPC) of the instrument. No query form.
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.
CALibrate:RESults:SPC? might return :CALibrate:RESults:SPC INIT indicating SPC has not be run successfully.
Returns the status of internal and factory calibrations without performing any calibration operations. It is intended to support GO/NoGO testing of calibration readiness and does not include attached probe calibration status.
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 channel number <x> can vary from 1 through 4 depending on the instrument model.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR> | Turns current status on or off, or uses a numeric value where 0 turns it off and any other value turns it on. |
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 value of <x> can vary from 1 through 4 depending on the instrument model.
CH<x>:AMPSVIAVOLTs:ENABLe? Ch1:AMPSVIAVOLTS:ENABLE ON will change the Ch1 measure current status as Yes.
Returns the vertical parameters for the specified channel. The value of <x> can vary from 1 through 4 depending on instrument model. Because CH<x>:SCAle and CH<x>:VOLts are identical, only CH<x>:SCAle is returned.
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. The channel number <x> can vary from 1 through 4 depending on the channel.
| Name | Type | Values | Description |
|---|---|---|---|
| factor | real | 1 - 4 | Factor value. |
CH<x>:AMPSVIAVOLTs:FACTOR 1 will set it as 1 A per volt measurement.
Sets or queries the current factor for channel <x>. The channel number can vary from 1 through 4 depending on the model.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 1 - 4 | Factor value. |
CH<x>:AMPSVIAVOLTs:FACTOR 1
Sets or queries the current factor for the specified current-measurement channel. The channel number <x> can vary from 1 through 4 depending on the channel.
| Name | Type | Values | Description |
|---|---|---|---|
| factor | real | - | Factor value. |
CH<x>:AMPSVIAVOLTs:FACTOR 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 4 depending on instrument model; this command is equivalent to setting the BW Limit option in the Vertical menu.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TWEnty | FULl | Selects the channel bandwidth limit or disables bandwidth limiting. |
| value | real | - | Sets the bandwidth limit using a double-precision ASCII value that is geometrically rounded to an available bandwidth. |
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 4 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 channel. The value of <x> can vary from 1 through 4 depending on the instrument model.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AC | DC | Selects AC or DC coupling for the specified channel. |
CH1:COUPLING AC CH2:COUPLING?
Sets or queries the input attenuator coupling setting of the specified instrument channel. The value of <x> can vary from 1 through 4 depending on the instrument model.
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 deskew time for channel <x>. This adds an independent, channel-based delay to compensate for differences in individual input hookups.
| Name | Type | Values | Description |
|---|---|---|---|
| deskew time | real | -100 ns - +100 ns | Deskew time for channel <x>. |
CH4 :DESKEW 5.0E-9 CH2:DESKEW?
Sets or queries the deskew time for the specified channel. The deskew time adds an independent channel-based delay to compensate for differences in input hookup delays.
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 inversion state of the specified instrument channel. The channel number x can vary from 1 through 4 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 CH2:INVERT?
Sets or queries the inversion state of the specified instrument channel. The channel number <x> can vary from 1 through 4 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 through 4.
| Name | Type | Values | Description |
|---|---|---|---|
| qstring | string | - | Alphanumeric text, enclosed in quotes, containing the label for the channel waveform. The text string is limited 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 waveform label for channel x, where x is the channel number 1-4. The label is an alphanumeric quoted string limited to 30 characters.
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>. The offset shifts the vertical acquisition window and the displayed input signal is always the input minus the offset value.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | -20 V - 20 V | Offset value for the specified channel <x>. |
CH3 :OFFSet 2.0E-3 CH4 :OFFSet?
Sets or queries the vertical offset for channel <x>. It offsets the vertical acquisition window for the specified channel; the offset range depends on the vertical scale factor.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 4 | Channel number. |
| offset | real | -0.8 V - 0.8 V | Offset value for the specified channel. |
CH3 :OFFSet 2.0E-3 sets the offset for channel 3 to 2 mV. CH4 :OFFSet? might return : CH4 :OFFSET 1.0000E-03 indicating that the offset for channel 4 is set to 1 mV.
Sets or queries the vertical position of channel <x> relative to the center graticule. The value is specified in divisions.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | -5 - 5 | Position in divisions from the center graticule for the specified channel. |
CH2:POSITION 1.3E0 CH1:POSITION?
Queries the vertical position of the specified channel in divisions from the center graticule. The position range is 5 to -5 divisions.
CH1:POSITION? might return :CH1:POSITION -1.3000 indicating that the vertical position of Channel 1 is 1.3 divisions below the center graticule.
Returns all information concerning the probe attached to channel <x>, where x is the channel number. The value of <x> can vary from 1 through depending on the instrument model.
CH1:PROBE? might return CH1:PROBE 10 .
Returns all information concerning the probe attached to channel <x>, where x is the channel number.
CH1:PROBE? might return CH1:PROBE 10 .
Sets the probe gain for channel <x>. Allowed values depend on the specific probe.
| Name | Type | Values | Description |
|---|---|---|---|
| gain | real | - | Probe gain for the selected channel. |
CH1:PRObe:GAIN 0.1 CH2:PROBE:GAIN? might return :CH2:PROBE:GAIN 0.1000E+00
Sets or queries the probe gain for channel <x>. The probe gain value is a real number whose allowed values depend on the specific probe.
CH1:PRObe:GAIN 0.1 sets the channel 1 probe gain to 0.1. CH2:PROBE:GAIN? might return :CH2:PROBE:GAIN 0.1000E+00 indicating that the attached 10x probe delivers 1 V to the channel 2 BNC for every 10 V applied to the probe input.
Returns the serial number of the probe attached to channel <x>. Query only; for Level 0 and 1 probes, the serial number is empty ("").
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 a generic "No Probe Detected" message.
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 | Selects whether the probe is in Bypass or Pass mode. |
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 input bypass mode. |
CH1:PRObe:SIGnal PASS CH1:PRObe:SIGnal?
Returns a string describing the units of measure for the probe attached to channel <x>, where x is the channel number. Query only.
Sets or queries the vertical scale of the specified instrument channel. For channel waveforms, it controls the vertical size of the acquisition window and display scale; for reference and math waveforms, it controls display only.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | - | The scale value, in units-per-division, truncated to three significant digits. |
CH1:SCALE 100E-3 CH2:SCALE?
Sets or queries the vertical scale of the specified channel. The scale is entered in units per division and is truncated to three significant digits.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | - | Vertical scale in units-per-division. |
CH1:SCALE 100E-3 sets the channel 1 gain to 100 mV/div. 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.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | V | The vertical sensitivity, in volts. |
CH1:VOLts 1.0 CH1:VOLts?
Sets or queries the vertical sensitivity of the specified channel. It is identical to CH<x>:SCAle and is included for compatibility purposes.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | V | The 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 |
|---|---|---|---|
| units | string | - | Quoted text specifying the supported units. |
CH2:YUNit "V" CH2:YUNIT might return CH2:YUNIT "V"
Sets or queries the units of the specified channel. String arguments are case insensitive, and unsupported units generate an error.
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 setting can also be changed 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.
Returns whether the cursor feature is enabled or disabled. Query only.
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. |
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? might return CURSOR:FUNCTION SCREEN indicating that the screen cursors are currently selected.
Returns the settings for the instrument horizontal bar cursors. Query only.
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, expressed in vertical units. The cursor 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 | Horizontal bar cursor position relative to ground; units depend on the selected source. |
Sets or returns the horizontal bar cursor position relative to ground, expressed in the measurement units for the selected source. The cursor specified by x can be 1 or 2.
| 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. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| units | 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 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 horizontal bar measurement scale. |
Sets or returns whether the two waveform cursors move linked together in unison or independently. This applies only when waveform cursors are displayed.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TRACk | INDependent | Ties the navigational functionality of the two cursors together, or allows 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? might return CURSOR:VBARS:UNITS SECONDS; POSITION1 1.00E-6;POSITION2 9.00E-6 .
Returns the alternate readout for the waveform (Vbar) cursor 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 readout to return. |
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, except for FFT math waveforms where the result is always in Hertz.
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 ticks for cursor <x>. The units are specified by the CURSor:HBArs:UNIts query.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies the cursor; valid values are 1 and 2. |
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 expressed in the units selected by CURSor:VBArs:UNIts, or in Hertz for an FFT math waveform. 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 vertical bar 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.
Positions a vertical bar cursor. The position is specified in the units set by CURSor:VBArs:UNIts and is relative to the trigger, except for math FFT waveforms where it is 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 vertical bar cursor units as seconds or Hertz. |
CURSor:VBArs:UNIts SECONDS CURSor:VBArs:UNIts?
Sets or queries the units for the vertical bar cursors. When Trigger View is active, the query generates event 221 (Settings conflict).
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 query sends waveform data from the instrument to an external device; the command sends waveform data from an external device to the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| dataopt | 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 query sends data from the instrument to an external device; the command form transfers waveform data from an external device to the instrument.
CURVe? with ASCII encoding, start and stop of 1 and 10 respectively, and a width set to 1 might return the following ASCII data: :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 transferred with the CURVe command. The setter accepts INIT or SNAp to reinitialize or align waveform data settings.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INIT | SNAp | Sets the waveform data settings to factory defaults or matches the current waveform 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 for storing waveform data transferred into the instrument by the CURVe command.
| Name | Type | Values | Description |
|---|---|---|---|
| REF<x> | string | - | Reference memory location used for waveform data storage. |
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 |
|---|---|---|---|
| source | enum | CH1 | CH2 | CH3 | CH4 | MATH | REF1 | REF2 | Specifies which waveform source will be transferred from the instrument to the controller. |
DATA:SOURCE CH1 specifies that the channel 1 waveform will be transferred in the next CURVe? query. DATa:SouRce REF1 specifies that reference waveform REF1 will be transferred in the next CURVe? query. DATa:SouRce? might return :DATA:SOURCE REF2 indicating that the source for the waveform data which is transferred using a CURVe? query is reference 2.
Sets the first data point to transfer for waveform data. The value ranges from 1 to the record length; data is transferred from this point to :DATA:STOP or the record length, whichever is less.
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 1 - record length | First data point that will be transferred. |
DATa:STARt 10 DATa:STARt? might return :DATA:START 214
Sets or queries the last data point in the waveform that will be transferred when using the CURVe? query. It is used to transfer partial waveforms from the instrument, and values above the record length are limited to the record length.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR1> | integer | 1 - record length | Last data point that will be transferred. |
Sets or queries the number of bytes per data point in waveform data transferred using the CURVe command. The setting can be 1 byte (8 bits) or 2 bytes (16 bits).
| Name | Type | Values | Description |
|---|---|---|---|
| NR1 | integer | 1 - 2 | Number of bytes per waveform data point. |
DATa:WIDth 1 sets the data width to 1 byte per data point for CURVe data.
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 date on the instrument display.
Sets or queries the bits in the Device Event Status Enable Register (DESER). The register is the mask that 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 bit mask. |
DESE 209 sets the DESER to binary 11010001, which enables the PON, URQ, EXE, and OPC bits.
Enables or disables bits in the Device Event Status Enable Register (DESER). The DESER controls which event types are reported to the SESR and the Event Queue.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Bit pattern to load into the DESER. |
Reads the Device Event Status Enable Register (DESER).
Returns the currently set PWM fan value. Query only.
DIAG:FAN? might return PWM=10, VOL=7.4V.
Returns the currently set PWM fan value. Only query.
DIAG:FAN? might return PWM=10, VOL=7.4V.
Sets the self-test loop option.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ALWAYS | FAIL | ONFAIL | ONCE | NTIMES | Selects how the diagnostics self-test loop behaves. |
DIAg:LOOP:OPTion ONCE sets diagnostics to run one loop of self tests.
Sets the number of self-test loops. The query form returns the current loop count.
| Name | Type | Values | Description |
|---|---|---|---|
| count | 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.
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) 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--RO M,NOT RUN--APPKEY" for power-up diagnostics.
Sets the type of diagnostics grouping. No query form.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ALL | APPKey | CPU | DISplay | FPAnel | IO | ROM | ACQ | Selects which diagnostic group or groups 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 the single instrument subsystem on which to run self tests. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | EXECute | ABORt | Selects whether diagnostics are started or stopped at the end of the current loop. |
DIAG:STATE EXECute starts diagnostics.
Reads out the currently FPGA chip and ambient temperature. Only query.
DIAG:TEMPVAL? might return: VDC Temp=-256, Ambient Temp=32
Reads out the currently FPGA chip and ambient temperature. Query only.
Sets and returns the display graticule intensity settings.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | NR1 | ON | OFF | Turns the graticule on or off in the screen display. |
DISPLAY:GRATICULE 0 sets NO graticule to display. DISPLAY:GRATICULE? might return :DISPLAY:GRATICULE 1 indicating that the graticule is on.
Sets and returns the waveform backlight intensity settings.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR1> | real | - | Backlight intensity setting. |
Sets or returns the display persistence state 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 value where 0 turns persistence off and 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.
Sets the persistence value when persistence is on. The value may be a time, AUTO, or INFInite; this affects the display only.
| Name | Type | Values | Description |
|---|---|---|---|
| value | numeric | - | Time of the persistence, or AUTO/INFInite as specified in the syntax. |
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 you have reached the end of the log. Use ERRLOG:FIRST? to start at the top of the error log, then ERRLOG:NEXT? to step through the log.
ERRLOG:NEXT?
Removes a single event code from the Event Queue associated with the results of 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 next event from the Event Queue and returns the event number together with a text description of the event. Reading an event removes it from the queue.
Returns the number of event codes in the Event Queue. This is a query only and 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.
Resets the instrument to its factory default settings. It clears status registers, purges aliases, enables all command headers, and does not reset communication settings, calibration data, protected user data, stored settings, the Power On Status Clear Flag, or the instrument password.
FACTORY resets the instrument to its factory default settings. Refer to Factory Setup.
Sets the instrument to the default state.
FACTORY
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 verification. |
Sets or queries the FFT horizontal display position.
Returns all FFT parameters. Query only.
Sets or queries the horizontal scale of the FFT waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | - | 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 source of the FFT waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH1 | CH2 | Source channel for the FFT waveform. |
Sets or queries the FFT source waveform display state. A value of 0 does not display the FFT source waveform; any other value displays it.
| Name | Type | Values | Description |
|---|---|---|---|
| state | integer | 0 | FFT source waveform display state; 0 turns the display off, any other value turns it on. |
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 |
|---|---|---|---|
| scale | 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.
Queries the FFT vertical measurement units label.
Sets the FFT waveform vertical units.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DB | LINEAr | FFT waveform vertical units. |
Returns or sets the FFT waveform vertical units. The query may return DB.
FFT:VType DB sets the FFT waveform vertical units to dB. FFT:VType? might return DB.
Sets or queries the FFT window type.
| Name | Type | Values | Description |
|---|---|---|---|
| window type | enum | HAMming | HANning | RECTangular | BLAckmanharris | FFT window function to use. |
FFT:WINdow HAMMING FFT:WINdow?
Returns the current working directory and 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 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" 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.
Deletes a named file. If a directory name is specified, it deletes the directory and all of its contents; *.* deletes all files in the current or specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| file name | string | - | Name of the file or directory to delete. |
Returns a list of quoted strings, each naming a file or directory 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 all data on the specified device will be lost. Drive letters are case sensitive and must be upper case for this command.
| Name | Type | Values | Description |
|---|---|---|---|
| file path | string | - | The mass storage device path to format. |
FILES:FORMAT " USB0/"
Returns the amount of memory space available on the current drive, in bytes. Query only.
FILESystem:FREESpace? might return 6242501.
Creates a directory at the specified path. If no path is specified, the instrument creates the directory in the current working directory.
| Name | Type | Values | Description |
|---|---|---|---|
| directory path | string | - | Quoted string that defines the location and name of the directory to create. |
FILESYSTEM:MKDIR " USB0/NewDirectory" FILESYSTEM:CWD " USB0/MyDirectory";:FILESYSTEM:MKDIR "MyNewSubDirectory"
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. It can also move a file or folder by specifying the new name in a different folder.
| Name | Type | Values | Description |
|---|---|---|---|
| source | string | - | Existing file or folder to rename. |
| destination | string | - | New name, or new path and name, for the file or folder. |
Deletes a named directory and all of its contents. The directory must not be read-only, and it must be empty before you can delete it.
| 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. The file path is a quoted string; the data can be definite-length or indefinite-length arbitrary block program data.
| Name | Type | Values | Description |
|---|---|---|---|
| file path | string | - | Quoted string defining the file name and path. |
| data | block | - | Block data to write, either definite-length encoding or indefinite-length arbitrary block program data. |
Simulates the action of pressing a specified front-panel button. When the front panel is locked, the FPAnel:PRESS and FPAnel:TURN commands do not work.
| Name | Type | Values | Description |
|---|---|---|---|
| button | enum | ACQuire | SAVE Recall | MEASurement | UTILity | MATh | REF | FFT | TRIGger | FORCetrig | CH1 | CH2 | DEFaultsetup | COURse | FUNCtion | ZOOM | FINe | CURsor | RUnstop | SINGleseq | AUTOset | SETTO50 | HARDcopy | SEARCH | NEXT | PREV | MARK | RMENU1 | RMENU2 | RMENU3 | RMENU4 | RMENU5 | MENUOff | GPKNOB | HORZPos | Name of a front-panel button to simulate pressing. |
FPANEL:PRESS AUTOSET executes the instrument Autoset function.
Simulates the action of turning a specified front-panel control knob. No query form.
| Name | Type | Values | Description |
|---|---|---|---|
| knob | enum | GPKNOB | HORZPos | HORZScale | TRIGLevel | VERTPOS<n> | VERTSCALE<n> | Name of the front-panel control knob to turn. |
| nopt | integer | - | Rotation direction and magnitude; negative values turn counterclockwise and positive values turn clockwise. |
FPANEL:TURN TRIGLEVEL,10
Updates the oscilloscope firmware from a file on a USB flash drive. The update file TBS2000B.TEK must be in the root directory of the USB drive, or the oscilloscope shows a warning and the firmware is not updated.
Compatibility command identical to the HEADer query. It is included for compatibility with other Tektronix scopes.
Sets or queries the Response Header Enable State, which controls whether headers are included on applicable query responses. It does not affect IEEE Std 488.2 common commands.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Sets the Response Header Enable State true or false. |
HEADer OFF HEADer?
Queries the Response Header Enable State, which controls whether query responses include headers. The setting affects applicable query responses only; IEEE 488.2 common commands never return headers.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Help Everywhere display on or off for acquire measurements. |
Enables or disables the display of Help Everywhere information for the acquire measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | - |
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 | Turns Help Everywhere display for the cursor settings on or off. |
HELPevery:CURsor ON
Enables or disables the display of Help Everywhere information for the cursor module.
Enables or disables the display of Help Everywhere information for the FFT settings.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns Help Everywhere display on or off 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 Help Everywhere for the FFT 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 math module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the math module. |
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 | Turns Help Everywhere for the measurement module on or off. |
HELPevery:MEASUrement ON
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 | 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 trigger module.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables Help Everywhere for the trigger module. |
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 or disables the display of Help Everywhere information 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.
Queries the record length. Query only.
Returns all settings for the horizontal commands. Query only. Equivalent horizontal settings are normalized to HORizontal:MAIn:SCAle and HORizontal:MAIn:POSition in the response.
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.
Returns the current horizontal divisions. Query only.
HORizontal:DIVisions? might return 15.
Sets or queries the horizontal position. When Horizontal Delay Mode is on, the command stores a new horizontal position that is used when Delay 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: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 on, the command stores a new horizontal position that is used when Horizontal Delay Mode is turned off.
| 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:DELay:POSITION? might return 100 indicating that the horizontal position is set to 100%. HORIZONTAL:DELay:POSITION 50 sets the horizontal position to 50%.
Sets or returns the horizontal delay mode. OFF or 0 disables horizontal delay mode, and ON or any nonzero value enables it.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | ON | Sets the horizontal delay mode to off or on. |
| value | integer | 0 | Sets the horizontal delay mode using a numeric value; 0 sets it off and any other value sets it on. |
HORIZONTAL:DELAY:MODE OFF HORIZONTAL:MAIn:DELAY:MODE?
Returns the 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. This command is the same as HORizontal[:MAIn]:DELay:MODe.
Sets or returns the horizontal delay mode. OFF makes HORizontal:POSition position the waveform horizontally; ON makes HORizontal:DELay:TIMe position the waveform horizontally.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | ON | <NR1> | Horizontal delay mode. |
HORIZONTAL:DELAY:MODE OFF HORIZONTAL:MAIn:DELAY:MODE?
Sets or returns the horizontal delay mode. OFF and ON select whether horizontal position or horizontal delay time controls waveform positioning; <NR1> value 0 turns the mode off and any other value turns it on.
Sets or returns the horizontal delay state. This command 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. 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 |
|---|---|---|---|
| <NR3> | real | s | The delay time. |
HORizontal:DELay:TIME 0.3
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 | real | s | Delay time 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 | 1 ns - 100 s | Specifies the range from 1 (or 2) ns to 100 s, 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.
Queries the main horizontal time base scale. This command is query only and returns all settings for the time base.
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 | 1 ns - 100 s | 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 |
|---|---|---|---|
| value | real | 1 ns - 100 s | Time base horizontal scale per division. |
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.
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 - 5000000 | Supported horizontal record length value. |
HORIZONTAL:RECORDLENGTH 2000 HORIZONTAL:RECORDLENGTH?
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 | Enables or disables auto 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.
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. |
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. The setter form sets the horizontal record length of acquired waveforms.
HORIZONTAL:RECORDLENGTH? might return 2000 indicating that the horizontal record length is equal to 2000 data points.
Sets or returns the horizontal record length of acquired waveforms. The sample rate is automatically adjusted 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.
Returns the current horizontal roll mode state. Query only.
HORizontal:ROLL? might return HORizontal:ROLL ON indicating that roll mode is on.
Returns the current horizontal roll mode state. Query only.
Sets or queries the horizontal position when delay mode is OFF. It is similar to HORizontal:POSition.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | % | The 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. The position is 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 the horizontal delay position. The command is part of the Horizontal delay group.
Sets the horizontal scale. The command is listed in the Horizontal command group; no parameter details are shown in this page slice.
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 or queries the language used to display instrument information on the screen. This is equivalent to setting the Language option in the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| language | enum | - | Specifies the language used to display instrument information on the screen. |
LANGuage FRENch LANGuage?
Sets or queries the language the instrument uses to display information on the screen. This is equivalent to the Language option in the Utility menu.
LANGuage FRENch LANGuage?
Selects the interface language. The factory setup example shows the command setting the language to ENGLISH.
| Name | Type | Values | Description |
|---|---|---|---|
| language | enum | ENGLISH | Language to use for the interface. |
(:LANGUAGE ENGLISH)
Enables and disables all front-panel buttons and knobs. When the front panel is locked, FPAnel:PRESS and FPAnel:TURN commands do not work.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ALL | NONe | Selects whether all front-panel controls are disabled or enabled. |
Enables or disables all front-panel buttons and knobs. The query returns the current lock state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ALL | NONe | Locks all front-panel controls or re-enables them. |
LOCk ALL LOCk? might return :LOCK NONE indicating the front-panel controls are enabled by this command.
Sets the math waveform definition for the active math operation. The <QString> argument 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”.
Defines the math waveform source expression used for display. The argument must be one of the listed channel math expressions.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH1+CH2 | CH1-CH2 | CH2-CH1 | CH1*CH2 | Math waveform expression to display. |
MATH:DEFINE "CH1-CH2"
Sets or queries the math horizontal display position for math waveforms. The horizontal position is expressed as a percent of record.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | % | Math horizontal position in percent of record. |
MATH:HORizontal:POSition 20 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 horizontal position is specified as a percent of record.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | % | Math horizontal position in percent of record. |
MATH:HORizontal:POSition 20 MATH:HORizontal:POSition? might return 20.000
Sets the math horizontal display scale.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | - | Math display scale. |
MATH:HORizontal:SCALe 20.000E-6 sets the math horizontal display scale to 20 μs per division. MATH:HORizontal:SCALe? might return 20.000E-6 indicating the math horizontal display scale is 20 μs per division.
Sets the math horizontal display scale. The query returns the current math horizontal display scale.
MATH:HORizontal:SCALe 20.000E-6 sets the math horizontal display scale to 20 μs per division. MATH:HORizontal:SCALe? might return 20.000E-6 indicating the math horizontal display scale is 20 μs per division.
Queries the math horizontal measurement units label.
MATH:HORizontal:UNIts? might return “us” indicating the math horizontal units are μs.
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.
Sets or queries the math waveform display position. The value is specified in divisions from center screen.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | divisions | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| position | real | divisions | Math vertical position in divisions from center screen. |
MATH:VERtical:POSition 4 MATH:VERtical:POSition? might return -3.000
Sets or queries the vertical display scale for the math waveform display. The display scale is separate from the math waveform vertical scale in the math waveform preamble and is affected by the instrument vertical scale knob behavior.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | - | Specifies the math vertical scale in units per division. |
MATH:VERtical:SCAle 5.0E0 MATH:VERTical:SCALe? might return 5.000.
Sets or queries the vertical display scale for the math waveform. The display scale is in units per division and is distinct from the math waveform vertical scale in the 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.
MATH:VERTical:UNIts? might return “V”.
Queries the math vertical measurement units.
MATH:VERTical:UNIts? might return “V”.
Returns the current MEASUrement settings. Query only.
MEASUrement? might return the following:
Clears the existing measurement snapshot results and removes the snapshot window. Command only, with no query form.
MEASUrement:CLEARSNapshot
Allows educators to disable or enable the Measurement functions. The function can be manually set from the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | ON enables the measurement feature; OFF 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 set from the Utility menu.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | ON enables the measurement feature; OFF disables it. |
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 |
|---|---|---|---|
| state | enum | OFF | SCREen | CURSor | Measurement gating mode. |
MEASUREMENT:GATING CURSOR turns on measurement gating using the cursors as limits. 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. |
Returns all immediate measurement setup parameters. Immediate measurement selection is a query-only command and is not visible or accessible through the display screen or front panel.
Sets or queries the slope of the edge the instrument uses for the delay from or to waveform when taking an immediate delay measurement.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which waveform to use: 1 for the from waveform, 2 for the to waveform. |
| edge | enum | FALL | RISe | Selects the edge slope used for the 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 on the selected waveform. <x> specifies whether the from waveform (1) or to waveform (2) is used.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 2 | Specifies which waveform to use, where 1 is the from waveform and 2 is the to waveform. |
| edge | enum | FALL | RISe | Selects the falling or rising edge. |
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 query 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 all single source immediate measurements and specifies the source to measure from when taking an immediate delay or phase measurement.
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, Source1 is assumed.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH<x> | MATH | Selects the measurement source channel or the math waveform. |
MEASUREMENT:IMMED:SOURCE1 CH1 specifies channel 1 as the immediate measurement source. MEASUREMENT:IMMED:SOURCE1? might return indicating that channel 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 | Selects the immediate measurement type. |
Sets or queries the immediate measurement type.
| Name | Type | Values | Description |
|---|---|---|---|
| type | 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 | Measurement type to use for the immediate measurement. |
Returns the units for the immediate instrument measurement. Query only.
Returns the value of the measurement specified by the MEASUrement:IMMed:TYPe command. The measurement is immediately taken on the source(s) specified by a MEASUrement:IMMed:SOUrce1 command.
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, 1 through 6 depending on instrument model.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 1 - 6 | Identifies the measurement number. |
MEASUrement:IMMed:UNIts? might return :MEASUREMENT:IMMED:UNIts "s", indicating that the unit for the immediate measurement is seconds.
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 |
|---|---|---|---|
| edge | enum | FALL | RISe | Selects the edge slope used for the delay measurement. |
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. |
| edge | enum | FALL | RISe | Selects the edge slope used for the delay measurement. |
Returns the delay measurement parameters for the measurement specified by <x>, which 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 when taking a delay or phase measurement. For measurement <x>, the index is 1 through 6.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH<x> | MATH | Input source for the measurement. |
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 all single source measurements and specifies the source to measure from when taking a delay or phase measurement. Measurement index <x> identifies the measurement, 1 through 6.
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 number <x> ranges from 1 through 6.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | <NR1> | Controls whether the specified measurement slot is disabled or enabled. |
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 number <x> 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; <NR1>=0 disables it and any other value enables it. |
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 measurement <x> (1 through 6, depending on model). Setting any type other than NONE displays the MEASURE menu; the manual recommends using :MEASUrement:IMMed for programming measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | AMPlitude | AREa | BURst | CARea | CMEan | CRMs | DELay | FALL | FREQuency | HIGH | LOW | MAXimum | MEAN | MINImum | NDUty | NEDGECount | NOVershoot | NPULSECount | NWIdth | PDUty | PEDGECount | PERIod | PHAse | PK2Pk | POVershoot | PPULSECount | PWIdth | RISe | RMS | Specifies the on-screen periodic instrument measurement type. |
Sets or queries the on-screen periodic instrument measurement type for the measurement specified by <x>. It is equivalent to selecting the measurement type in the MEASURE menu.
MEASUREMENT:MEAS2:TYPE FREQUENCY specifies MEAS2 to measure the frequency of a waveform.
Returns the units for the instrument measurement specified by MEASUrement:MEAS<x>:TYPe. <x> identifies the measurement, 1 through 6; query only.
MEASUREMENT:MEAS3:UNITS? might return :MEASUREMENT:MEAS1:UNIts % indicating units for measurement 1 are set to percent.
Returns the calculated on-screen periodic measurement value for the specified measurement number. The value is the same as displayed on-screen and is updated periodically.
Sets or returns the low reference level. It is the lower reference level when :MEASUrement:REFLevel:METHod is set to Absolute.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | - | Low reference level value. |
Sets or queries the low reference level. When MEASUrement:REFLevel:METHod is set to Absolute, this is the lower reference level.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | - | Low reference level value. |
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 other cyclic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | 0.0 V | The mid reference level. |
MEASUREMENT:REFLEVEL:ABSOLUTE:MID 1.71 MEASUREMENT:REFLEVEL:ABSOLUTE:MID?
Sets or returns the absolute mid reference level for the first mid-point setting. It is the 50% reference level when the reference level method is set to Absolute, and it affects period, frequency, delay, and cyclic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | V | The mid reference level. |
MEASUREMENT:REFLEVEL:ABSOLUTE:MID 1.71 sets the mid reference level to 0.71 V. 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 reference level units used for measurement calculations. The method applies to 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 MEASUREMENT:REFLEVEL:METHOD?
Sets or returns the reference level units used for measurement calculations. The setting affects the associated reference level parameter for all MEASurements:IMMed and the eight periodic measurements.
MEASUREMENT:REFLEVEL:METHOD ABSOLUTE 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 percent used to calculate the high reference level when Measurement:REFLevel:METHod is set to Percent. It affects rise and fall measurements and the associated reference level parameter for all immediate and periodic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| high reference level | real | 0 - 100 | The high reference level percentage, where 100% is equal to HIGH. |
MEASUrement:REFLevel:PERCent:HIGH 95 MEASUrement:REFLevel:PERCent:HIGH? might return 90
Sets or returns the percent (where 100% is equal to HIGH) used to calculate the high reference level when MEASUrement:REFLevel:METHod is set to Percent. This command affects the results of rise and fall measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| high | real | 0 - 100 | High reference level percentage used to calculate the high reference level. |
MEASUrement:REFLevel:PERCent:HIGH 95 MEASUrement:REFLevel:PERCent:HIGH? might return 90 indicating that the percentage high reference level is set to 90% of HIGH.
Sets or returns the percent 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 as a percentage of HIGH. |
MEASUrement:REFLevel:PERCent:LOW?
Sets or returns the percent used to calculate the low reference level when MEASUrement:REFLevel:METHod is set to Percent. This affects the results of rise and fall measurements and the associated reference level parameter for all MEASurements:IMMed and the four periodic measurements.
MEASUrement:REFLevel:PERCent:LOW?
Sets or returns the percent of HIGH used to calculate the mid reference level when the reference level method is set to Percent. This command affects period, frequency, delay, and cyclic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 0 - 100 | Mid reference level percent used to calculate the mid reference level. |
MEASUrement:REFLevel:PERCent:MID[1] 60 MEASUrement:REFLevel:PERCent:MID[1]?
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 the results of period, frequency, delay, and all cyclic measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0 - 100 | Mid reference level percentage. |
MEASUrement:REFLevel:PERCent:MID[1] 60 MEASUrement:REFLevel:PERCent:MID[1]? might return 65 indicating that the percentage mid reference level is set to 65% of HIGH.
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.
Sets or returns the snapshot source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CH1 | CH2 | CH3 | CH4 | MATH | Snapshot source to use. |
MEASUrement:SOURCESNAPShot CH1 sets the snapshot source to channel 1. MEASUrement:SOURCESNAPShot? might return CH1 indicating the snapshot source is channel 1.
Clears the current measurement snapshot.
Captures the snapshot sources used by measurement functions.
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. |
| storage location | integer | 1 - 10 | Specifies a setup memory storage location. |
| file path | string | - | Specifies a setup file on a USB flash drive. |
Recalls a saved waveform file to a reference memory location. Command only, 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<x> | integer | 1 - 2 | Instrument 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.
Returns the date that reference waveform data for channel <x> was copied into 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>, where x is the reference channel number. 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.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | - | Reference channel number. |
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.
REF1:VERTical:POSition? might return :REF1:VERTICAL:POSITION -1.3000E+00 indicating that the current position of Reference 1 is 1.3 divisions below the center graticule.
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 | - | Reference channel number. |
REF2:VERTICAL:SCALE? might return :REF2:VERTICAL:SCALE 1.0000e+00 indicating that the current vertical scale setting for reference 2 is 1 V per division.
Sets the date associated with the selected reference waveform record.
Sets or queries what the front-panel Save button will store. The assignment can be screen images, waveforms, setups, or printer output.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | IMAGe | WAVEform | SETUp | PRINTer | Selects the data type assigned to the Save button. |
Saves the screen image to a file. It is command only, with no query form. The image format is determined by :SAVe:IMAge:FILEFormat? or set by :SAVe:IMAge:FILEFormat.
| 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" saves the screen image to the file VID-EVAL.BMP in the folder usb0\PROD-TST .
Sets or queries the file format used when saving screen images. The format is used when the file name does not determine the type 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.
| Name | Type | Values | Description |
|---|---|---|---|
| layout | enum | LANdscape | PORTRait | Specifies the saved screen image layout. |
SAVe:IMAge:LAYout LANdscape SAVe:IMAge:LAYout? might return :SAVe:IMAge:LAYout LANdscape indicating that images are saved in landscape format.
Saves the current state of the instrument into the specified memory location. This is equivalent to selecting the Save Setup option in the Save/Recall Setup menu and can later be restored with *RCL.
| Name | Type | Values | Description |
|---|---|---|---|
| file path | - | - | Path identifying where to save the current front-panel setup. |
| NR1 | integer | 1 - 10 | Front-panel setup memory location to save. |
Stores a waveform in one of the nonvolatile reference memory locations, or saves a specified waveform to a file. Only individual analog waveforms can be saved to reference memory locations; when the waveform file format is set appropriately, waveform data can also be saved to CSV or ISF files.
| Name | Type | Values | Description |
|---|---|---|---|
| wfm | enum | CH<x> | MATH | FFT | Specifies the waveform to save. |
| ref<x> | enum | REF<x> | Specifies the reference memory location to store the waveform. |
| QString | string | - | Specifies the quoted file path and name for saving the waveform file. |
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 resulting files for non-internal formats.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | INTERNal | SPREADSheet | File format used when saving waveforms. |
SAVe:WAVEform:FILEFormat INTERNAL SAVe:WAVEform:FILEFormat?
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | Turns on or off the display of the specified waveform; <NR1>=0 turns it off and any other value turns it on. |
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, and also selects the associated Math, FFT, or Reference waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| selection | enum | CH<x> | MATH | FFT | REF<x> | Waveform to make the recipient of future channel-related commands. |
SELect:CONTROl CH1 SELect:CONTROl?
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 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 | Turns the math waveform display on or off. |
| value | integer | 0 | 0 turns off the display of the specified waveform; 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 reference waveform <x>. The <x> variable represents the reference channel number. The query returns whether the channel is on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the display of the specified reference waveform on or off. |
| value | integer | 0 | A nonzero value turns on the display of the specified reference waveform; 0 turns it off. |
Returns most instrument settings and can be sent back to the instrument to restore the state captured by SET. This query is identical to *LRN? 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 operation is time-consuming and the instrument is inoperable until it completes.
Sets or queries the time the instrument displays. The time and date values are used to time stamp files and show the time and date on the instrument display.
| Name | Type | Values | Description |
|---|---|---|---|
| time | string | - | Time value in the form "hh:mm:ss". |
TIME "14:00:00" TIME? might return :TIME "11:25:03"
Forces a trigger event to occur. This command has no query form.
| Name | Type | Values | Description |
|---|---|---|---|
| FORCe | enum | 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, returns the current A trigger settings.
| Name | Type | Values | Description |
|---|---|---|---|
| SETLevel | enum | - | Sets the A trigger level to 50% of the minimum and maximum values of the trigger source input signal. |
TRIGger:A SETLEVEL TRIGGER:A?
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 |
|---|---|---|---|
| coupling | enum | DC | HFRej | LFRej | NOISErej | Selects the coupling type for the A edge trigger. |
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 | Slope used for the A edge trigger. |
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 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 | Selects the edge trigger source. |
Sets the 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 trigger level for the A trigger. The set form accepts ECL, TTL, or a numeric level in user units; 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? might return :TRIGGER:A:LEVel 1.3000E+00 indicating that the A edge trigger is set to 1.3 V.
Sets or queries the trigger level for the specified channel. Each channel can have an independent level.
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 | real | - | Channel index x in CH<x>. |
| level | real | V | Lower threshold level in volts or a preset ECL/TTL level. |
TRIGGER:A:LOWERTHRESHOLD:CH2 50E-3 TRIGGER:A:LOWERTHRESHOLD:CH2?
Sets or queries the trigger mode for trigger A. AUTO generates a trigger if one is not detected within a specific time period; NORMal waits for a valid trigger event.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | AUTO | NORMal | Trigger mode to set. |
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.
Queries the width for the pulse-width trigger. Query only.
TRIGger:A:PULSEWidth? might return :TRIGGER:A:PULSEWIDTH:POLARITY POSITIVE;WHEN LESSTHAN;WIDTH 8.0E-9
Queries the width for the pulse-width trigger. Query only.
TRIGger:A:PULSEWidth?
Sets or queries the type of pulse used for trigger A. RUNt triggers when a pulse crosses the first preset voltage threshold but does not cross the second before recrossing the first; WIDth triggers when a pulse is found with the specified polarity and time limits.
TRIGGER:A:PULSE:CLASS WIDTH TRIGGER:A:PULSE:CLASS? might return :TRIGGER:A:PULSE:CLASS WIDTH
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 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 the pulse is considered negative or positive polarity. |
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 whether to trigger on a pulse that is less than, more than, equal to, or not equal to the specified width range. 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 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 |
|---|---|---|---|
| <NR3> | real | - | Width value for the pulse width trigger. |
Sets or queries the polarity for the runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | NEGative | POSitive | Selects the runt trigger 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 an analog input channel as the trigger source. |
TRIGGER:A:RUNT:SOURCE sets channel as the source for the A pulse trigger. TRIGGER:A:RUNT:SOURCE? might return :TRIGGER:A:RUNT:SOURCE CH2 indicating that channel 2 is the source for the A pulse trigger.
Sets or queries the type of pulse width the trigger checks for when it detects a runt.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | LESSthan | MOREthan | EQual | UNEQual | OCCURS | Type of pulse width the runt trigger checks for. |
Sets or queries the width for a runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | s | Specifies the minimum width. |
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 upper threshold for channel <x>. Each channel can have an independent level, and this command is used only for runt trigger type.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | integer | - | Channel number <x>. |
| threshold | real | V | Threshold level in volts. |
| level | enum | ECL | TTL | Preset upper threshold level. |
TRIGGER:A:UPPERTHRESHOLD:CH2 50E-3 sets the upper limit of the pulse runt trigger to 50 mV for channel 2. TRIGGER:A:UPPERTHRESHOLD:CH2? might return :TRIGGER:A:UPPERTHRESHOLD:CH2 1.2000E-01 indicating that the upper limit of the pulse runt trigger is set to 120 mV.
Returns the edge or pulse width trigger frequency, matching the readout 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.
TRIGGER:STATE? might return :TRIGGER:STATE ARMED indicating that the pretrigger data is being acquired.
Selects the source for pulse trigger A. The command is part of the trigger A pulse setup subtree.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | - |
Returns the pulse-width trigger settings for Trigger A.
TRIGger:A:PULse:WIDth?
Sets the runt trigger configuration for trigger A.
Unlocks the front panel. This command is equivalent to LOCk NONe. Command only, 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 | Sets the Verbose state true or false. |
VERBose ON VERBose?
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.
VERBose? might return the value 1, showing that the Verbose state is true.
Enables or disables verbose mode for message handling.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns verbose mode on or off. |
Returns WFMOutpre? and CURVe? data for the waveform specified by :DATA:SOURCE. The response is synchronized preamble and curve data; the source waveform must be active or the query returns no data and generates 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 |
|---|---|---|---|
| bits | enum | 8 | 16 | Number of bits per waveform point for incoming binary waveform data. |
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 type of encoding for waveform data transferred with the CURVe command.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ASCii | BINary | Specifies whether waveform data is transferred as ASCII or binary. |
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.
Returns the number of points in the incoming waveform record.
:WFMINPRE:NR_PT ? might return :WFMINPRE:NR_PT 10000 indicating that there are 10000 data points in the expected incoming waveform record.
Sets or queries the horizontal interval between incoming waveform points. The value is expressed in the units specified by WFMInpre:XUNit.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | 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 | - | Contains a maximum of three alpha characters that represent the horizontal unit of measure for the incoming waveform. |
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 set to MATH FFT during acquisition.
| Name | Type | Values | Description |
|---|---|---|---|
| xzero | real | - | Position value, in XUNits, of the first sample of the incoming waveform relative to the trigger. |
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 |
|---|---|---|---|
| value | real | - | The 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 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 | - | Vertical position of the incoming waveform in digitizing levels. |
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 | YUNits | Offset expressed in YUNits. |
Returns waveform transmission and formatting settings for the waveform specified by the DATa:SOUrce command. If that waveform is not displayed, only the waveform transmission parameters are returned.
Sets and queries the number of bits per waveform point in outgoing waveforms, as 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 sets the number of bits per waveform point to 16 for outgoing waveforms. WFMOUTPRE:BIT_NR? might return :WFMOUTPRE:BIT_NR 8 indicating that outgoing waveforms use 8 bits per waveform point.
Sets or returns the binary data format for outgoing waveforms specified by the DATa:SOUrce command. Changing WFMOutpre:BN_Fmt also changes the value of DATa:ENCdg.
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? might return :WFMOUTPRE:BYT_NR 2
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 generate an error if the waveform specified by DATa:SOUrce is not turned on.
WFMOUTPRE:NR_PT? might return :WFMOUTPRE:NR_PT 10000 indicating that there are 10000 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 acquisition parameters for the waveform specified by DATa:SOUrce. The query times out and generates an error if the specified waveform 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 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 selected waveform 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. The value is expressed in the units returned by WFMOutpre:XUNit?.
Returns the vertical scale factor per digitizing level in 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 generates an error if the selected 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 selected 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 in units specified by WFMOutpre:YUNit? for the waveform specified by the DATa:SOUrce command. 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.
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 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 |
|---|---|---|---|
| NR3 | real | 0 - 100.00 | Percent of the upper window that is to the left of screen center. |
ZOOM:ZOOM1:HORizontal:POSition 50.00 sets the zoom reference pointer at 50% of the acquired waveform. ZOOM:ZOOM1:HORIZONTAL:POSITION? might return :ZOOM1:HORIZONTAL:POSITION 50.00, indicating the reference pointer is at 50% of the acquired waveform.
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. |
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 |
|---|---|---|---|
| NR3 | real | 0 - 100.00 | Percent of the upper window that is to the left of screen center. |
ZOOM:ZOOM1:POSition 50.00 ZOOM:ZOOM1:POSITION?
Sets or queries the specified zoom on or off. For the setter, ON enables the specified zoom, OFF disables it, and 0 disables the specified zoom while any other value enables it.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the specified zoom on or off. |
| value | integer | 0 | 0 disables the specified zoom; any other value enables the specified zoom. |
ZOOM:ZOOM1:STATE ON turns Zoom1 on.
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.
Selects the first zoom window. The command appears in the zoom subsystem index, with related zoom settings listed on the same manual page range.
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 |
|---|---|---|---|
| state | enum | ON | OFF | <NR1> | 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.
Reads the Event Status Enable Register (ESER).
Reads the Service Request Enable Register (SRER). The register controls which bits in the Status Byte Register generate a service request and are summarized by the Master Status Summary (MSS) bit.
Places a 1 in the output queue once all pending operations that generate an OPC message have completed. The query does not return until synchronization is complete, so it is used to wait for an acquisition or other operation to finish.
Reserved word for the instrument. The page lists *CAL among the instrument's reserved words, but does not document its function, parameters, or return value here.
Clears the status data structures and the error queue.
Reserved word for the instrument. The slice only lists *ESE among reserved words and does not document its syntax or behavior here.
Reserved word for the instrument's standard command set.
Returns the instrument identification string. This command is a reserved word.
Reserved word for the instrument; the slice lists *LRN among the instrument's reserved words.
Reserved word recognized by the instrument. It is listed among the instrument's reserved words.
Sets the power-on state of the instrument's front-panel setup recall mode. This is a reserved word command listed by the manual, but the provided slice does not document its syntax or parameter details.
Recalls a previously stored front-panel setup or instrument state. This is a reserved common command.
| Name | Type | Values | Description |
|---|---|---|---|
| setup | integer | 0 - 9 | Storage location to recall. |
Resets the instrument to its default state. It is a reserved common command word.
Reserved word for the instrument. The slice only lists *SAV among reserved words and does not document any syntax, parameters, or return value for it.
Reserved word for the instrument. The manual lists *SRE among the instrument's reserved words.
Returns the status byte value. The command is listed among the instrument's reserved words.
Waits until all pending commands are completed before the instrument continues processing. This is a reserved word for the instrument.
Reads the next event number from the Event Queue. Reading an event removes it from the queue; before reading, the *ESR? query must be used to summarize the event into the queue.
Reports whether the instrument is busy processing a command with extended processing time. It is intended for use in a polling loop while waiting for acquisition or other long operations to complete.
Sets the vertical scale for channel 1. The example shows setting CH1:VOLTS to 2.0.
| Name | Type | Values | Description |
|---|---|---|---|
| volts | real | V | Vertical scale for channel 1. |
Sets the horizontal main timebase scale. The example shows setting it to 100e-6.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | s/div | Horizontal main timebase scale. |
HOR:MAIN:SCALE 100e-6
Sets the type of immediate measurement used for built-in waveform measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | MEAN | FREQ | Measurement type to use for immediate measurements. |
MEASU:IMMED:TYPE MEAN MEASU:IMMED:TYPE FREQ
Returns the current value of the immediate measurement. The example shows it after setting :MEASU:IMMED:TYPE to a measurement type such as MEAN or FREQ.
Sets the trigger level for the main trigger system. The programming example shows :TRIG:MAIN:LEVEL 2.4.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | - | Trigger level to set. |
:TRIG:MAIN:LEVEL 2.4
Returns the waveform preamble describing the current waveform data format and scaling information. The example response shows fields such as BYT_NR, BIT_NR, ENCDG, BN_FMT, BYT_OR, and NR_PT.
:WFMPRE?