Summary of Contents for Agilent Technologies 3000 Series
Page 1
Agilent 3000 Series Oscilloscopes Programmer’s Reference Agilent Technologies...
Page 2
In This Book This book is your guide to programming the 3000 Series oscilloscopes. • Chapter 1, “I/O Module Installation and Configuration” on page 7 contains information on the installation and use of the I/O Module. • Chapter 2, “Introduction to Programming” on page 13 gives you an introduction to programming the oscilloscopes, along with necessary conceptual information.
I/O Module Installation The I/O module (N2861A) provides an RS-232 serial port and a GPIB port that can be used to remotely program the 3000 Series oscilloscopes. Figure 2 shows the back panel installation location for the I/O module. Figure 2...
Page 9
I/O Module Installation and Configuration I/O Module Installation Be sure to turn off the power before installing the I/O module. Figure 3 shows how to install the I/O module. Figure 3 Installing the I/O Module After installation is complete, restart the oscilloscope. The system will automatically detect the I/O module.
I/O Module Installation and Configuration I/O Module Configuration I/O Module Configuration After installing the I/O module, the port that you are going to use for remotely programming the oscilloscope must be configured. To configure the I/O module, press the front panel UTILITY key. In the UTILITY menu select the IO Setting menu key.
Page 11
I/O Module Installation and Configuration I/O Module Configuration Turn on the oscilloscope. Press front panel UTILITY key. Select the I/O Setting menu key. Set the menu to the same baud rate as that of the PC. RS-232 Baud Start the terminal-emulator program. Send the *IDN? query.
Page 12
I/O Module Installation and Configuration I/O Module Configuration GPIB Configuration The GPIB address can be set to any value from 0 to 30. GPIB Interface Testing GPIB is the standard for 8 bit parallel communication. The oscilloscope can communicate with a computer, a controller, or a terminal. The character that is used to terminate a command or query is a new line (0x0A hex) character.
Introduction to Programming This chapter introduces the basics for remote programming of an oscilloscope. The programming commands provide the means of remote control. Basic operations that you can do with a computer and an oscilloscope include: • Set up the oscilloscope. •...
Introduction to Programming Truncation Rule Truncation Rule The truncation rule is used to produce the short form (abbreviated spelling) for the mnemonics used in the programming commands, queries, and parameter arguments. Command Truncation Rule The mnemonic is the first four characters of the keyword, unless the fourth character is a vowel.
Introduction to Programming Braces Braces When several items are enclosed by braces, {}, only one of these elements may be selected. Vertical line ( | ) indicates "or". For example, {ON | OFF} indicates that only ON or OFF may be selected, not both. Ellipsis ...
Remote Command Tips Tip: When writing automated testing routines using the 3000 Series oscilloscope, be sure to use the *OPC? query. The *OPC? query returns a value of '1' when the oscilloscope is finished executing the last command. Waiting for the *OPC? query to return a '1' before issuing the next command ensures that no commands or data are lost.
Page 20
Commands Quick Reference The following table provides a quick reference of the commands implemented in the 3000 Series oscilloscopes. Table 5 Commands Quick Reference Command Query Options and Query Returns Common Commands *CLS *IDN? AGILENT TECHNOLOGIES,<model>,<serial number>,XX.XX.XX <model> ::= the model number of the instrument <serial number>...
Page 21
Commands Quick Reference Command Query Options and Query Returns :CHANnel<n> Commands :CHANnel<n>:BWLimit { { 1 | ON } :CHANnel<n>:BWLimit? { 1 | 0 } | { 0 | OFF } } <n> ::= 1 - 2 :CHANnel<n>:COUPling { DC | AC :CHANnel<n>:COUPling? { DC | AC | GND } | GND }...
Page 28
Common commands can be received and processed by the oscilloscope, whether they are sent over the GPIB as separate program messages or within other program messages. The common commands implemented in the 3000 Series oscilloscopes are: “*CLS (Clear Status)” on page 29 •...
Common Commands *IDN? (Identification Number) *IDN? (Identification Number) Query *IDN? The *IDN? query returns the company name, oscilloscope model number, serial number, and software revision number. Returned Format AGILENT TECHNOLOGIES,<model>,<serial_number>,<rev_number>< NL> <model> Oscilloscope model number. <serial_number> Specifies the serial number of the oscilloscope. The first four digits and letter are the serial prefix, which is the same for all identical oscilloscopes.
Common Commands *OPC? (Operation Complete) *OPC? (Operation Complete) Query *OPC? The *OPC? query places an ASCII character “1” in the oscilloscope's output queue when all pending selected device operations have finished. Returned Format 1<NL>...
Common Commands *RST (Reset) *RST (Reset) Command *RST The *RST command places the oscilloscope in a known state. This command loads the Factory setup.
Page 34
Root Level Commands Root level commands control many of the basic operations of the oscilloscope that you can select by pressing the labeled keys on the front panel. These commands are always recognized by the parser if they are prefixed with a colon, regardless of the current tree position. After executing a root level command, the parser is positioned at the root of the command tree.
Root Level Commands AUTO AUTO Command :AUTO The :AUTO command causes the oscilloscope to evaluate all input waveforms and find the optimum conditions for displaying the waveform. It searches each of the channels for input waveforms and shuts off channels where no waveform is found.
Root Level Commands ForceTrig ForceTrig Command :ForceTrig The :ForceTrig command starts an start an acquisition even if a valid trigger has not been found. This command has no effect if the acquisition is already stopped.
Root Level Commands Command :RUN The :RUN command starts the oscilloscope running. When the oscilloscope is running, it acquires waveform data according to its current settings. Acquisition runs repetitively until the oscilloscope receives a :STOP command, or until a single acquisition has occurred when the Trigger Sweep is set to Single.
Root Level Commands STOP STOP Command :STOP The :STOP command causes the oscilloscope to stop acquiring data. To restart the acquisition, use the :RUN command.
Page 42
ACQuire Commands The ACQuire subsystem commands set up conditions for acquiring waveform data. These ACQuire commands and queries are implemented in the 3000 Series oscilloscopes: “AVERages” on page 43 • “MODE” on page 44 • “SRATe?” on page 45 • “TYPE”...
ACQuire Commands AVERages AVERages Command :ACQuire:AVERages {2 | 4 | 8 | 16 | 32 | 64 | 128 | 256} The :ACQuire:AVERages command sets the number of averages for the waveforms. Query :ACQuire:AVERages? The :ACQuire:AVERages? query returns the number of averages. Returned Format {2 | 4 | 8 | 16 | 32 | 64 | 128 | 256}<NL>...
ACQuire Commands MODE MODE Command :ACQuire:MODE {RTIMe | ETIMe} The :ACQuire:MODE command sets the acquisition mode of the oscilloscope. • The :ACQuire:MODE RTIMe command sets the oscilloscope in real time mode. This mode is useful to inhibit equivalent time sampling at fast sweep speeds.
ACQuire Commands SRATe? SRATe? Command :ACQuire:SRATe Query :ACQuire:SRATe? The :ACQuire:SRATe? query returns the current oscilloscope acquisition sample rate. The sample rate is not directly controllable. Returned Format <sample_rate><NL> <sample_rate> ::= sample rate in NR3 format...
ACQuire Commands TYPE TYPE Command :ACQuire:TYPE {NORMal | AVERage | PEAK} The :ACQuire:TYPE command selects the type of data acquisition that is to take place. The acquisition types are: NORMal, AVERage and PEAK. • The :ACQuire:TYPE NORMal command sets the oscilloscope in the normal mode.
Page 48
BEEP Commands The BEEP subsystem commands control all beep functions of the oscilloscope. These BEEP commands and queries are implemented: “ENABle” on page 49 •...
BEEP Commands ENABle ENABle Command :BEEP:ENABle {{ 1 | ON} | {0 | OFF}} The :BEEP:ENABle command enables the audible beep on the oscilloscope. Query :BEEP:ENABle? The :BEEP:ENABle? query shows whether the audible beep is enabled or disabled. Returned Format {1 | 0}<NL>...
Page 52
CHANnel<n> Commands The CHANnel<n> subsystem commands control all vertical (Y axis) functions of the oscilloscope. These CHANnel<n> commands and queries are implemented: “BWLimit” on page 53 • “COUPling” on page 54 • “DISPlay” on page 55 • “INVert” on page 56 •...
CHANnel<n> Commands BWLimit BWLimit Command :CHANnel<n>:BWLimit {{ 1 | ON} | {0 | OFF}} The :CHANnel<n>:BWLimit command controls an internal low-pass filter. When the filter is on, the bandwidth of the specified channel is limited to approximately 25 MHz. <n> 1 or 2 Query :CHANnel<n>:BWLimit? The :CHANnel<n>:BWLimit? query returns the current setting of the low-pass...
CHANnel<n> Commands COUPling COUPling Command :CHANnel<n>:COUPling {DC | AC | GND} The :CHANnel<n>:DISPlay command turns the display of the specified channel on or off. The :CHANnel<n>:COUPling command selects the input coupling for the specified channel. The coupling for each channel can be set to AC, DC, or GND. <n>...
CHANnel<n> Commands DISPlay DISPlay Command :CHANnel<n>:DISPlay {{ 1 | ON} | {0 | OFF}} The :CHANnel<n>:DISPlay command turns the display of the specified channel on or off. <n> 1 or 2 Query :CHANnel<n>:DISPlay? The :CHANnel<n>:DISPlay? query returns the current display condition for the specified channel.
CHANnel<n> Commands INVert INVert Command :CHANnel<n>:INVert {{ 1 | ON} | {0 | OFF}} The :CHANnel<n>:INVert command selects whether or not to invert the input signal for the specified channel. The inversion may be 1 (ON/inverted) or 0 (OFF/not inverted). <n>...
CHANnel<n> Commands OFFSet OFFSet Command :CHANnel<n>:OFFSet <offset_value> The :CHANnel<n>:OFFSet command sets the voltage that is represented at the center of the display for the selected channel. <n> 1 or 2 <offset_value> -8div to +8div Query :CHANnel<n>:OFFSet? The :CHANnel<n>:OFFSet? query returns the current offset value for the specified channel.
CHANnel<n> Commands PROBe PROBe Command :CHANnel<n>:PROBe <attn_value> The :CHANnel<n>:DISPlay command turns the display of the specified channel on or off. The :CHANnel<n>:PROBe command specifies the probe attenuation factor for the selected channel. The probe attenuation factor may be 1, 10, 100, or 1000. This command does not change the actual input sensitivity of the oscilloscope.
CHANnel<n> Commands SCALe SCALe Command :CHANnel<n>:SCALe <scale_value> The :CHANnel<n>:SCALe command sets the vertical scale, or units per division, of the selected channel. This command is the same as the front-panel channel scale. <n> 1 or 2 <scale_value> A number in exponential format for the vertical scale of the channel in units per division.
Page 62
COUNter Commands The COUNter subsystem commands control all frequency counter functions of the oscilloscope. These COUNter commands and queries are implemented: “ENABle” on page 63 • “VALue?” on page 64 •...
COUNter Commands ENABle ENABle Command :COUNter:ENABle {{ 1 | ON} | {0 | OFF}} The :COUNter:ENABle command enables the frequency counter. The frequency counter counts trigger level crossings at the selected trigger slope and displays the results in Hz. The gate time for the measurement is automatically adjusted to be 100 ms or twice the current time window, whichever is longer, up to 1 second.
COUNter Commands VALue? VALue? Query :COUNter:VALue? The :COUNter:VALue? query returns the frequency counter value. Returned Format <counter_value><NL> <counter_value> ::= in Hz in NR3 format...
Page 66
DISPlay Commands The DISPlay subsystem controls the display of data, text, and grids, and the use of color. These DISPlay commands and queries are implemented in the 3000 Series oscilloscopes: “CLEar” on page 67 • “GRID” on page 68 • “MENUdisplay”...
DISPlay Commands CLEar CLEar Commands :DISPlay:CLEar The :DISPlay:CLEar command clears the display and resets all associated measurements. If the oscilloscope is stopped, all currently displayed data is erased. If the oscilloscope is running, all of the data for active channels and functions is erased;...
DISPlay Commands GRID GRID Command :DISPlay:GRID {FULL | HALF | NONE} The :DISPlay:GRID command selects the type of graticule that is displayed. • In FULL grid mode, the oscilloscope has a 12-by-8 (unit) display grid, a grid line is place on each vertical and horizontal division. •...
DISPlay Commands MENUdisplay MENUdisplay Command :DISPlay:MENUdisplay {1s | 2s | 5s | 10s | 20s | INFinite} The :DISPlay:MENUdisplay command sets the amount of time that a menu display once activated. Query :DISPlay:MENUdisplay? The :DISPlay:MENUdisplay? query returns the amount of time that the on screen menu appears when activated.
DISPlay Commands PERSistence PERSistence Command :DISPlay:PERSistence {{1 | ON} | {0 | OFF}} The :DISPlay:PERSistence command sets the display persistence of waveforms off or on. • When persistence is OFF, waveforms are erased from the screen at the end of each trigger cycle. •...
DISPlay Commands SCReen SCReen :DISPlay:SCReen {NORMal | INVerted} The :DISPlay:SCReen command sets the color scheme of the display. When set to inverted, display colors are changed to their inverse colors. Query :DISPlay:SCReen? The :DISPlay:SCReen? query returns the state of the screen control. Returned Format {NORMal | INVerted}<NL>...
Page 72
DISPlay Commands TYPE TYPE Command :DISPlay:TYPE {DOTS | VECTors} The :DISPlay:TYPE command sets the way that waveforms are drawn. When set to VECTors, waveforms are drawn with lines connecting adjacent sample points. When set to DOTS, only the waveform sample points are drawn. Query :DISPlay:TYPE? The :DISPlay:TYPE? query returns the state of the type control.
Page 74
KEY commands control many of the basic operations of the oscilloscope that you can select by pressing the front panel keys. These KEY commands and queries are implemented in the 3000 Series oscilloscopes: • “Commands for Front Panel Actions” on page 75.
KEY Commands Commands for Front Panel Actions Commands for Front Panel Actions Table 6 KEY Commands Command: Is the same as this Front Panel action: :KEY:ACQUIRE Pressing the Acquire key. :KEY:AUTO_SCALE Pressing the Autoscale key. The :KEY:AUTO_SCALE command causes the oscilloscope to evaluate all input waveforms and find the optimum conditions for displaying the waveforms.
Page 76
KEY Commands Commands for Front Panel Actions Command: Is the same as this Front Panel action: :KEY:MATH Pressing the Math key. :KEY:MEASURE Pressing the Meas key. :KEY:MNU_ON_OFF Pressing the MENU ON/OFF key. :KEY:MODE_COUPLING Pressing the Mode/Coupling button. :KEY:PROMPT_TIME Pressing the Horizontal Scale knob. :KEY:REF Pressing the Ref key.
KEY Commands LOCK LOCK Command :KEY:LOCK {ENABle | DISable} The :KEY:LOCK command enables or disables the front panel. Query :KEY:LOCK? The :KEY:LOCK? query returns the current state of the front panel lock control. Returned Format {ENABle | DISable}<NL>...
Page 80
MASK Commands The MASK subsystem controls the Mask Test function. These MASK commands and queries are implemented in the 3000 Series oscilloscopes: “ENABle” on page 81 • “OPERate” on page 82 • “OUTPut” on page 83 • “SOURce” on page 84 •...
MASK Commands ENABle ENABle Command :MASK:ENABle {{1 | ON} | {0 | OFF}} The :MASK:ENABle command enables or disables the Mask Test function. Query :MASK:ENABle? The :MASK:ENABle? query returns the state of the mask enable control. Returned Format {1 | 0}<NL>...
MASK Commands OPERate OPERate Command :MASK:OPERate {RUN | STOP} The :MASK:OPERate command runs or stops the Mask Test function. Query :MASK:OPERate? The :MASK:OPERate? query returns whether the Mask Test function is running or stopped. Returned Format {RUN | STOP}<NL>...
MASK Commands OUTPut OUTPut Command :MASK:OUTPut {FAIL | FAIL_SOUND | PASS | PASS_SOUND} The :MASK:OUTPut command specifies the condition that, when detected, will cause an indication and whether the indication will include an audible beep. Query :MASK:OUTPut? The :MASK:OUTPut? query returns the current output setting. Returned Format {FAIL | FAIL_SOUND | PASS | PASS_SOUND}<NL>...
MASK Commands SOURce SOURce Command :MASK:SOURce {CHAN1 | CHAN2} The :MASK:SOURce command selects either channel 1 or channel 2 as the source for the Mask Test. Query :MASK:SOURce? The :MASK:SOURce? query returns the channel that is currently selected as the source for the Mask Test. Returned Format {CHAN1 | CHAN2}<NL>...
MASK Commands STOPonoutput STOPonoutput Command :MASK:STOPonoutput {{1 | ON} | {0 | OFF}} The :MASK:STOPonoutput command specified whether the Mask Test stops when the output condition occurs. Query :MASK:STOPonoutput? The :MASK:STOPonoutput? query returns the state of the “stop on output” control.
Page 86
MASK Commands Command :MASK:X <value> The :MASK:X command sets the mask’s horizontal failure margin. <value> 0.4 div to 4 div Query :MASK:X? The :MASK:X? query returns the current horizontal failure margin setting. Returned Format <value><NL> <value> ::= 0.4 div to 4 div...
Page 87
MASK Commands Command :MASK:Y <value> The :MASK:Y command sets the mask’s vertical failure margin. <value> 0.4 div to 4 div Query :MASK:Y? The :MASK:Y? query returns the current vertical failure margin setting. Returned Format <value><NL> <value> ::= 0.4 div to 4 div...
Page 90
MEASure Commands The commands in the MEASure subsystem are used to make parametric measurements on displayed waveforms. These MEASure commands and queries are implemented in the 3000 Series oscilloscopes. “CLEar” on page 91 • “FALLtime” on page 92 • “FREQuency” on page 93 •...
MEASure Commands FALLtime FALLtime Command :MEASure:FALLtime [{CHANnel1 | CHANnel2}] The :MEASure:FALLtime command displays the on-screen fall time measurement. Query :MEASure:FALLtime? [{CHANnel1 | CHANnel2}] The :MEASure:FALLtime? query returns the fall time. Returned Format <value><NL> <value> Time from the upper threshold time to the lower threshold time. Note: the value returned can contain a “<“...
MEASure Commands FREQuency FREQuency Command :MEASure:FREQuency [{CHANnel1 | CHANnel2}] The :MEASure:FREQuency command displays the on-screen ffrequency measurement. Query :MEASure:FREQuency? [{CHANnel1 | CHANnel2}] The :MEASure:FREQuency? query returns the measured frequency. Returned Format <value><NL> <value> The frequency value in Hertz of the first complete cycle on the screen using the mid-threshold levels of the waveform (in NR3 format).
MEASure Commands NDUTycycle NDUTycycle Command :MEASure:NDUTycycle [{CHANnel1 | CHANnel2}] The :MEASure:NDUTycycle command displays the on-screen negative duty cycle measurement. Query :MEASure:NDUTYcycle? [{CHANnel1 | CHANnel2}] The :MEASure:NDUTycycle? query returns the measured negative duty cycle in percent (%). Returned Format <value><NL> <value> The ratio (%) of the negative pulse width to the period. Note: the value returned contains a “%“...
MEASure Commands NWIDth NWIDth Command :MEASure:NWIDth [{CHANnel1 | CHANnel2}] The :MEASure:NWIDth command displays the on-screen negative pulse width measurement. Query :MEASure:NWIDth? [{CHANnel1 | CHANnel2}] The :MEASure:NWIDth? query returns the measured width of the first negative pulse. Returned Format <value><NL> <value> The width of the first negative pulse on the screen using the mid-threshold levels of the waveform (in NR3 format).
MEASure Commands OVERshoot OVERshoot Command :MEASure:OVERshoot [{CHANnel1 | CHANnel2}] The :MEASure:OVERshoot command displays the on-screen overshoot measurement. Query :MEASure:OVERshoot? [{CHANnel1 | CHANnel2}] The :MEASure:OVERshoot? query returns the measured overshoot. Returned Format <value><NL> <value> Ratio of overshoot to amplitude, in percent. Note: the value returned contains a “%“...
MEASure Commands PDUTycycle PDUTycycle Command :MEASure:PDUTycycle [{CHANnel1 | CHANnel2}] The :MEASure:PDUTycycle command displays the on-screen positive duty cycle measurement. Query :MEASure:PDUTYcycle? [{CHANnel1 | CHANnel2}] The :MEASure:PDUTycycle? query returns the measured positive duty cycle in percent (%). Returned Format <value><NL> <value> The ratio (%) of the positive pulse width to the period. Note: the value returned contains a “%“...
MEASure Commands PERiod PERiod Command :MEASure:PERiod [{CHANnel1 | CHANnel2}] The :MEASure:PERiod command displays the on-screen period measurement. Query :MEASure:PERiod? [{CHANnel1 | CHANnel2}] The :MEASure:PERiod? query returns the measured period. Returned Format <value><NL> <value> Period of the first complete cycle on the screen (in NR3 format).
MEASure Commands PREShoot PREShoot Command :MEASure:PREShoot [{CHANnel1 | CHANnel2}] The :MEASure:PREShoot command displays the on-screen preshoot measurement. Query :MEASure:PREShoot? [{CHANnel1 | CHANnel2}] The :MEASure:PREShoot? query returns the measured preshoot. Returned Format <value><NL> <value> Ratio of preshoot to amplitude, in percent. Note: the value returned contains a “%“...
MEASure Commands PWIDth PWIDth Command :MEASure:PWIDth [{CHANnel1 | CHANnel2}] The :MEASure:PWIDth command displays the on-screen positive pulse width measurement. Query :MEASure:PWIDth? [{CHANnel1 | CHANnel2}] The :MEASure:PWIDth? query returns the measured width of the first positive pulse. Returned Format <value><NL> <value> Width of the first positive pulse on the screen in seconds (in NR3 format).
MEASure Commands RISetime RISetime Command :MEASure:RISetime [{CHANnel1 | CHANnel2}] The :MEASure:RISetime command displays the on-screen rise time measurement. Query :MEASure:RISetime? [{CHANnel1 | CHANnel2}] The :MEASure:RISetime? query returns the rise time. Returned Format <value><NL> <value> Rise time in seconds. Note: the value returned can contain a “<“ character, so it is best to read this value as a string.
MEASure Commands VAMPlitude VAMPlitude Command :MEASure:VAMPlitude [{CHANnel1 | CHANnel2}] The :MEASure:VAMPlitude command displays the on-screen voltage amplitude measurement. Query :MEASure:VAMPlitude? [{CHANnel1 | CHANnel2}] The :MEASure:VAMPlitude? query returns the calculated difference between the top and base voltage. Returned Format <value><NL> <value> Calculated difference between the top and base voltage (in NR3 format).
MEASure Commands VAVerage VAVerage Command :MEASure:VAVerage [{CHANnel1 | CHANnel2}] The :MEASure:VAVerage command displays the on-screen average voltage measurement. Query :MEASure:VAVerage? [{CHANnel1 | CHANnel2}] The :MEASure:VAVerage? query returns the calculated average voltage. Returned Format <value><NL> <value> The calculated average voltage (in NR3 format).
MEASure Commands VBASe VBASe Command :MEASure:VBASe [{CHANnel1 | CHANnel2}] The :MEASure:VBASe command displays the on-screen base voltage measurement. Query :MEASure:VBASe? [{CHANnel1 | CHANnel2}] The :MEASure:VBASe? query returns the measured voltage value at the base. Returned Format <value><NL> <value> Voltage at the base of the waveform (in NR3 format).
MEASure Commands VMAX VMAX Command :MEASure:VMAX [{CHANnel1 | CHANnel2}] The :MEASure:VMAX command displays the on-screen maximum voltage measurement. Query :MEASure:VMAX? [{CHANnel1 | CHANnel2}] The :MEASure:VMAX? query returns the measured absolute maximum voltage. Returned Format <value><NL> <value> Absolute maximum voltage present on the waveform (in NR3 format).
MEASure Commands VMIN VMIN Command :MEASure:VMIN [{CHANnel1 | CHANnel2}] The :MEASure:VMIN command displays the on-screen minimum voltage measurement. Query :MEASure:VMIN? [{CHANnel1 | CHANnel2}] The :MEASure:VMIN? query returns the measured absolute minimum voltage. Returned Format <value><NL> <value> Absolute minimum voltage present on the waveform (in NR3 format).
MEASure Commands Command :MEASure:VPP [{CHANnel1 | CHANnel2}] The :MEASure:VPP command displays the on-screen peak-to-peak voltage measurement. Query :MEASure:VPP? [{CHANnel1 | CHANnel2}] The :MEASure:VPP? query returns the peak-to-peak voltage. Returned Format <value><NL> <value> Peak-to-peak voltage (in NR3 format).
MEASure Commands VRMS VRMS Command :MEASure:VRMS [{CHANnel1 | CHANnel2}] The :MEASure:VRMS command displays the on-screen RMS voltage measurement. Query :MEASure:VRMS? [{CHANnel1 | CHANnel2}] The :MEASure:VRMS? query returns the RMS voltage. Returned Format <value><NL> <value> RMS voltage of the selected waveform (in NR3 format).
MEASure Commands VTOP VTOP Command :MEASure:VTOP [{CHANnel1 | CHANnel2}] The :MEASure:VTOP command displays the on-screen voltage at the top measurement. Query :MEASure:VTOP? [{CHANnel1 | CHANnel2}] The :MEASure:VTOP? query returns the measured voltage at the top. Returned Format <value><NL> <value> Voltage at the top of the waveform (in NR3 format).
Page 112
SAVerecall Commands The SAVerecall subsystem commands perform the setup and waveform storage operations. This allows saving and loading of waveforms and setups. These SAVerecall commands and queries are implemented in the 3000 Series oscilloscopes: “LOAD” on page 113 • “LOCation” on page 114 •...
SAVerecall Commands LOAD LOAD Command :SAVerecall:LOAD The :SAVerecall:LOAD command restores a setup or a waveform from the storage area defined by the :SAVerecall:LOCation command. The :SAVerecall:TYPE command determines if a waveform or setup is loaded.
SAVerecall Commands LOCation LOCation Command :SAVerecall:LOCation {1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10} The :SAVerecall:LOCation command defines which storage location is used by the :SAVerecall:LOAD and :SAVerecall:SAVE commands. Query :SAVerecall:LOCation? The :SAVerecall:LOCation? query returns the currently selected storage...
SAVerecall Commands SAVE SAVE Command :SAVerecall:SAVE The :SAVerecall:SAVE command saves a setup or a waveform to a storage area. The :SAVerecall:LOCation command determines which storage area is used. The :SAVerecall:TYPE command determines if a waveform or setup is saved.
SAVerecall Commands TYPE TYPE Command :SAVerecall:TYPE {WAVeforms | SETups} The :SAVerecall:TYPE command defines whether a waveform or setup is stored in the storage location. Query :SAVerecall:TYPE? The :SAVerecall:TYPE? query returns the currently selected storage type. Returned Format {WAVeforms | SETups}<NL>...
Page 118
TIMebase Commands The TIMebase subsystem commands control the horizontal (X axis) oscilloscope functions. These TIMebase commands and queries are implemented in the oscilloscope: “DELayed” on page 119 • “HOLDoff” on page 120 • “POSition” on page 121 • “SCALe” on page 122 •...
TIMebase Commands DELayed DELayed Command :TIMebase:DELayed {{1 | ON} | {0 | OFF}} The :TIMebase:DELayed command enables or disables the Delayed Sweep mode. Query :TIMebase:DELayed? The :TIMebase:DELayed? query returns the state of the Delayed Sweep mode control. Returned Format {1 | 0}<NL>...
TIMebase Commands HOLDoff HOLDoff Command :TIMebase:HOLDoff <holdoff_time> The :TIMebase:HOLDoff command sets the holdoff time. The holdoff time is the oscilloscope's waiting period before starting a new trigger. During the holdoff time oscilloscope will not trigger until the holdoff has expired. Holdoff can be used to stabilize a waveform. <holdoff_time>...
TIMebase Commands POSition POSition Command :TIMebase:POSition <delay_time> The :TIMebase:POSition sets the amount of time from the center of screen to the trigger point of the waveform. <delay_time> If the horizontal time base is set between 50 s/div and 50 ms/div, the delayed trigger time range is: ±...
TIMebase Commands SCALe SCALe Command :TIMebase:SCALe <time> The :TIMebase:SCALe command sets the time base scale. This corresponds to the horizontal scale value displayed as Time on the oscilloscope screen. <time> The time value is in a 1-2-5 sequence (for example, 1.0E-9, 2.0E-9, 5.0E-9, ..., 1.0E+00, 2.0E+00, 5.0E+00) from: •...
TIMebase Commands SCAN SCAN Query :TIMebase:SCAN? The :TIMebase:SCAN? query returns whether the oscilloscope is in the Roll Mode (1 = yes, 0 = no). Returned Format {1 | 0}<NL>...
Page 126
TRIGger Commands The oscilloscope trigger circuitry helps you locate the waveform you want to view. Edge triggering identifies a trigger condition by looking for the slope and voltage level (trigger level) on the source you select. The commands in the TRIGger subsystem define the conditions for triggering.
TRIGger Commands [:EDGE]:COUPling [:EDGE]:COUPling Command :TRIGger[:EDGE]:COUPling {DC | AC | HF | LF} The :TRIGger[:EDGE]:COUPling command sets the input coupling for the selected trigger sources. The coupling can be set to DC, AC, HF, or LF. • DC sets the input coupling to DC. •...
TRIGger Commands [:EDGE]:LEVel [:EDGE]:LEVel Command :TRIGger[:EDGE]:LEVel <level>} The :TRIGger[:EDGE]:LEVel command specifies the trigger level. <level> A number in the range of +12div to -12div. Query :TRIGger[:EDGE]:LEVel? The query returns the trigger level. Returned Format <level><NL>...
TRIGger Commands [:EDGE]:SLOPe [:EDGE]:SLOPe Command :TRIGger[:EDGE]:SLOPe {NEGative | POSitive} The :TRIGger[:EDGE]:SLOPe command specifies the slope of the edge used to trigger the oscilloscope. Query :TRIGger[:EDGE]:SLOPe? The query returns the currently selected edge slope. Returned Format {NEGative | POSitive}<NL>...
TRIGger Commands [:EDGE]:SOURe [:EDGE]:SOURe Command :TRIGger[:EDGE]:SOURe { CHANnel CHANnel 2 | EXT |EXT5 | ACLine} The :TRIGger[:EDGE]:SOURe command sets the source used for triggering. Query :TRIGger[:EDGE]:SOURe? The query returns the currently selected trigger source. Returned Format {CHANnel1 | CHANnel2 | EXT | EXT5 | ACLine}<NL>...
TRIGger Commands [:EDGE]:SWEep [:EDGE]:SWEep Command :TRIGger[:EDGE]:SWEep {AUTO | NORMal} The :TRIGger[:EDGE]:SWEep command selects the oscilloscope sweep mode. <AUTO> When you select AUTO, if a trigger event does not occur within a time determined by the oscilloscope settings, the oscilloscope automatically forces a trigger which causes the oscilloscope to sweep.
TRIGger Commands MODE MODE Command :TRIGger:MODE {EDGE | PULSe | TV} The :TRIGger:MODE command sets the trigger mode. Query :TRIGger:MODE? The query returns the currently selected trigger mode. Returned Format {EDGE | PULSE | TV}<NL>...
TRIGger Commands PULSe:MODE PULSe:MODE Command :TRIGger:PULSe:MODE {+GREaterthan | +LESSthan | +EQUal | -GREaterthan | -LESSthan | -EQUal} The :TRIGger:PULSe:MODE command sets the pulse trigger mode. The “+” options are for positive pulses; the “-” options are for negative pulses. Query :TRIGger:PULSe:MODE? The query returns the currently selected pulse trigger mode.
TRIGger Commands PULSe:WIDTh PULSe:WIDTh Command :TRIGger:PULSe:WIDTh <width>} The :TRIGger:PULSe:WIDTh command specifies the pulse trigger width. <width> 20 ns to 10 s. Query :TRIGger:PULSe:WIDTh? The query returns the current pulse trigger width setting. Returned Format <width><NL> <width> ::= in NR3 format...
TRIGger Commands VIDeo:POLarity VIDeo:POLarity Command :TRIGger:VIDeo:POLarity {POSitive | NEGative} The :TRIGger:VIDeo:POLarity command sets the edge of the sync pulse to trigger on. Query :TRIGger:VIDeo:POLarity? The query returns the current sync pulse edge setting. Returned Format {POSitive | NEGative}<NL>...
TRIGger Commands VIDeo:STANdard VIDeo:STANdard Command :TRIGger:VIDeo:STANdard {NTSC | PALSecam} The :TRIGger:VIDeo:STANdard command sets they type of video waveform to trigger on. Query :TRIGger:VIDeo:STANdard? The query returns the currently selected video trigger waveform type. Returned Format {NTSC | PALSecam}<NL>...
TRIGger Commands VIDeo:SYNC VIDeo:SYNC Command :TRIGger:VIDeo:SYNC {FIELd1 | FIELd2 | LINE | ALLLines} The :TRIGger:VIDeo:SYNC command sets the line or field in the video waveform to trigger on. • FIELd1 triggers on an odd field. • PIELd2 triggers on and even field. •...
Page 140
WAVeform Commands The WAVeform subsystem is used to transfer waveform data from the oscilloscope to a computer. It contains commands to transfer waveform information and waveform data from the oscilloscope. These WAVeform commands and queries are implemented in the 3000 Series oscilloscopes: “DATA?”...
WAVeform Commands DATA? DATA? Query :WAVeform:DATA? The :WAVeform:DATA? query outputs waveform data to the computer over the selected interface. This query is the same as the :WAVeform:SCREENDATA? query. Use the :WAVeform:SOURce command to determine which channel waveform data is output. Returned Format <block_data><NL>...
WAVeform Commands ERASeofroll? ERASeofroll? Query :WAVeform:ERASeofroll? The :WAVeform:ERASeofroll? query returns the width in points of the erase band when in Roll Mode. Returned Format <roll_erase_wid><NL> <roll_erase_wid> ::= integer in NR1 format.
WAVeform Commands MAXPeakdetect? MAXPeakdetect? Query :WAVeform:MAXPeakdetect? The :WAVeform:MAXPeakdetect? query outputs the peak detect maximum waveform data to the computer over the selected interface. This query is the same as the :WAVeform:SCREENMAX? query. Use the :WAVeform:SOURce command to determine which channel waveform data is output.
WAVeform Commands MEMorydata? MEMorydata? Query :WAVeform:MEMorydata? The :WAVeform:MEMorydata? query outputs the reference memory waveform data to the computer over the selected interface. Use the :WAVeform:SOURce command to determine which channel waveform data is output. Returned Format <block_data><NL> See Also “Block Data” on page 17.
WAVeform Commands MINPeakdetect? MINPeakdetect? Query :WAVeform:MINPeakdetect? The :WAVeform:MINPeakdetect? query outputs the peak detect maximum waveform data to the computer over the selected interface. This query is the same as the :WAVeform:SCREENMIN? query. Use the :WAVeform:SOURce command to determine which channel waveform data is output.
WAVeform Commands SCREENDATA? SCREENDATA? Query :WAVeform:SCREENDATA? The :WAVeform:SCREENDATA? query outputs waveform data to the computer over the selected interface. This query is the same as the :WAVeform:DATA? query. Use the :WAVeform:SOURce command to determine which channel waveform data is output. Returned Format <block_data><NL>...
WAVeform Commands SCREENMAX? SCREENMAX? Query :WAVeform:SCREENMAX? The :WAVeform:SCREENMAX? query outputs the peak detect maximum waveform data to the computer over the selected interface. This query is the same as the :WAVeform:MAXPeakdetect? query. Use the :WAVeform:SOURce command to determine which channel waveform data is output.
WAVeform Commands SCREENMIN? SCREENMIN? Query :WAVeform:SCREENMIN? The :WAVeform:SCREENMIN? query outputs the peak detect maximum waveform data to the computer over the selected interface. This query is the same as the :WAVeform:MINPeakdetect? query. Use the :WAVeform:SOURce command to determine which channel waveform data is output.
WAVeform Commands SOURce SOURce Command :WAVeform:SOURce {CHANnel1 | CHANnel2} The :WAVeform:SOURce command selects a channel as the waveform source. Query :WAVeform:SOURce? The :WAVeform:SOURce? query returns the currently selected waveform source. Returned Format {CHANnel1 | CHANnel2}<NL>...
WAVeform Commands STARtofroll? STARtofroll? Query :WAVeform:STARtofroll? The :WAVeform:STARtofroll? query returns the waveform’s starting position when in Roll Mode. Returned Format <roll_start_pos><NL> <roll_Start_pos> ::= Integer in NR1 format.
WAVeform Commands SYSMemsize? SYSMemsize? Query :WAVeform:SYSMemsize? The :WAVeform:SYSMemsize? query returns the points value of the waveform in system memory. Returned Format <memory_data_size><NL> <memory_data_size> ::= Integer in NR1 format. See Also “MEMorydata?” on page 144.
WAVeform Commands TPOSition? TPOSition? Query :WAVeform:TPOSition? The :WAVeform:TPOSition? query returns the points value in the current waveform preamble. The points value is the number of time buckets contained in the waveform selected with the :WAVeform:SOURce command. Returned Format <trig_pos><NL> <trig_pos> ::= Integer in NR1 format.
WAVeform Commands WINMemsize? WINMemsize? Query :WAVeform:WINMemsize? The :WAVeform:WINMemsize? query returns the points value of the waveform in the window’s memory. Returned Format <window_data_size><NL> <window_data_size> ::= Integer in NR1 format. See Also “DATA?” on page 141.
WAVeform Commands WPOSition? WPOSition? Query :WAVeform:WPOSition? The :WAVeform:WPOSition? query returns the points value in the current waveform position. Returned Format <wave_pos><NL> <wave_pos> ::= Integer in NR1 format.
WAVeform Commands XEND? XEND? Query :WAVeform:XEND? The :WAVeform:XEND? query returns the horizontal end position points value. Returned Format <screen_wave_endx><NL> <screen_wave_endx> ::= Integer in NR1 format.
WAVeform Commands XINCrement? XINCrement? Query :WAVeform:XINCrement? The :WAVeform:XINCrement? query returns the time difference between consecutive data points for the currently specified waveform source. • For time domain waveforms, this is the time difference between consecutive data points. • For VERSus type waveforms, this is the duration between levels on the X axis. •...
WAVeform Commands XORigin? XORigin? Query :WAVeform:XORigin? The :WAVeform:XORigin? query returns the X-axis value of the first data point in the data record. • For time domain waveforms, it is the time of the first point. • For VERSus type waveforms, it is the X-axis value at level zero. •...
WAVeform Commands XSTart? XSTart? Query :WAVeform:XSTart? The :WAVeform:XSTart? query returns the horizontal start position points value. Returned Format <screen_wave_startx><NL> <screen_wave_startx> ::= Integer in NR1 format...
WAVeform Commands YINCrement? YINCrement? Query :WAVeform:YINCrement? The :WAVeform:YINCrement? query returns the y-increment voltage value for the currently specified source. This voltage value is the voltage difference between two adjacent waveform data digital codes. Adjacent digital codes are codes that differ by one least significant bit. For example, the digital codes 24680 and 24681 vary by one least significant bit.
WAVeform Commands YORigin? YORigin? Query :WAVeform:YORigin? The :WAVeform:YORigin? query returns the y-origin voltage value for the currently specified source. The voltage value returned is the voltage value represented by the waveform data digital code 00000. Returned Format <real_value><NL> <real_value> ::= A real number in exponential format.
Page 167
(for volt- age reduction or mains isola- tion), the common terminal must be connected to the earth termi- nal of the power source. Agilent Technologies Inc. P.O. Box 2197 1900 Garden of the Gods Road Colorado Springs, CO 80901-2197, U.S.A.