Artisan Technology Group is your source for quality new and certified-used/pre-owned equipment • FAST SHIPPING AND DELIVERY • TENS OF THOUSANDS OF IN-STOCK ITEMS • EQUIPMENT DEMOS • HUNDREDS OF MANUFACTURERS SUPPORTED • LEASING/MONTHLY RENTALS • ITAR CERTIFIED SECURE ASSET SOLUTIONS SERVICE CENTER REPAIRS Experienced engineers and technicians on staff at our full-service, in-house repair center WE BUY USED EQUIPMENT Sell your excess, underutilized, and idle used equipment We also offer credit for buy-back
Programmer’s Guide Publication number 54600-97032 April 2001 This guide contains programming information for the following Agilent oscilloscope models: 54600 54601 54602 54603 54610 54615 54616 For Safety information, Warranties, and Regulatory information, see the pages behind the Index. © Copyright Agilent Technologies 1995-1996, 2001 All Rights Reserved Agilent 54600-Series Oscilloscopes Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming the Oscilloscope When you attach an interface module to the rear of the Agilent 54600Series Oscilloscopes, the oscilloscope becomes programmable. That is, you can hook a controller (such as a PC or workstation) to the oscilloscope, and write programs on that controller to automate oscilloscope setup and data capture. Both GPIB (also known as IEEE-488) and RS-232-C interfaces are available. The following figure shows the basic structure of every program you will write for the oscilloscope.
Capture Once you initialize the oscilloscope, you can begin capturing data for measurement. Remember that while the oscilloscope is responding to commands from the controller, it is not performing acquisitions. Also, when you change the oscilloscope configuration, any data already captured is most likely invalid. To collect data, you use the DIGITIZE command. This command clears the waveform buffers and starts the acquisition process.
In This Book The Agilent 54600-Series Oscilloscopes Programmer’s Guide is your introduction to programming the Agilent 54600-Series Oscilloscopes using an instrument controller. This book, with the online Agilent 54600-Series Oscilloscopes Programmer’s Reference, provides a comprehensive description of the oscilloscope’s programmatic interface. The Programmer’s Reference is supplied as a Microsoft Windows Help file on a 3.5" diskette.
For information on oscilloscope operation, see the Agilent 54600-Series Oscilloscopes User and Service Guide. For information on interface configuration, see the documentation for the oscilloscope and the interface card used in your controller (for example, the 82341C interface for IBM PC-compatible computers).
vi Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Contents 1 Introduction to Programming Talking to the Instrument 1–3 Program Message Syntax 1–4 Combining Commands from the Same Subsystem 1–7 Duplicate Mnemonics 1–7 Query Command 1–8 Program Header Options 1–9 Program Data Syntax Rules 1–10 Program Message Terminator 1–12 Selecting Multiple Subsystems 1–12 2 Programming Getting Started Initialization 2–3 Autoscale 2–4 Setting Up the Instrument 2–4 Example Program 2–5 Using the DIGitize Command 2–6 Receiving Information from the Instrument 2–8 String Var
Contents Minimum three-wire interface with software protocol 4–4 Extended interface with hardware handshake 4–5 Configuring the Interface 4–7 Interface Capabilities 4–8 Communicating over the RS-232-C bus 4–9 Lockout Command 4–10 5 Programming and Documentation Conventions Command Set Organization 5–3 The Command Tree 5–6 Truncation Rules 5–10 Infinity Representation 5–11 Sequential and Overlapped Commands 5–11 Response Generation 5–11 Notation Conventions and Definitions 5–12 Program Examples 5–13 6 Sta
1 Introduction to Programming Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Introduction to Programming Chapters 1 and 2 introduce the basics for remote programming of an oscilloscope. The programming instructions in this manual conform to the IEEE 488.2 Standard Digital Interface for Programmable Instrumentation. The programming instructions provide the means of remote control. To program the Agilent 54600-series oscilloscope you must add either an GPIB (for example, Agilent 54650A) or RS-232-C (for example, Agilent 54651A) interface to the rear panel.
Introduction to Programming Talking to the Instrument Talking to the Instrument Computers acting as controllers communicate with the instrument by sending and receiving messages over a remote interface. Instructions for programming normally appear as ASCII character strings embedded inside the output statements of a “host” language available on your controller. The input statements of the host language are used to read in responses from the oscilloscope.
Introduction to Programming Program Message Syntax Program Message Syntax To program the instrument remotely, you must understand the command format and structure expected by the instrument. The IEEE 488.2 syntax rules govern how individual elements such as headers, separators, program data, and terminators may be grouped together to form complete instructions. Syntax definitions are also given to show how query responses are formatted.
Introduction to Programming Program Message Syntax Instructions Instructions (both commands and queries) normally appear as a string embedded in a statement of your host language, such as BASIC, Pascal, or C. The only time a parameter is not meant to be expressed as a string is when the instruction’s syntax definition specifies , such as learnstring. There are only a few instructions which use block data.
Introduction to Programming Program Message Syntax Header Types There are three types of headers: · Simple Command headers. · Compound Command headers. · Common Command headers. Simple Command Header Simple command headers contain a single mnemonic. AUTOSCALE and DIGITIZE are examples of simple command headers typically used in this instrument. The syntax is: Simple command headers must occur at the beginning of a program message; if not, they must be preceded by a colon.
Introduction to Programming Combining Commands from the Same Subsystem Combining Commands from the Same Subsystem To execute more than one function within the same subsystem a semi-colon (;) is used to separate the functions: ::; (For example :CHANNEL1:COUPLING DC;BWLIMIT ON) Duplicate Mnemonics Identical function mnemonics can be used for more than one subsystem.
Introduction to Programming Query Command Query Command Command headers immediately followed by a question mark (?) are queries. After receiving a query, the instrument interrogates the requested function and places the answer in its output queue. The answer remains in the output queue until it is read or another command is issued. When read, the answer is transmitted across the bus to the designated listener (typically a controller).
Introduction to Programming Program Header Options Program Header Options Program headers can be sent using any combination of uppercase or lowercase ASCII characters. Instrument responses, however, are always returned in uppercase. Program command and query headers may be sent in either long form (complete spelling), short form (abbreviated spelling), or any combination of long form and short form.
Introduction to Programming Program Data Syntax Rules Program Data Syntax Rules Program data is used to convey a variety of types of parameter information related to the command header. At least one space must separate the command header or query header from the program data. When a program mnemonic or query has multiple program data a comma separates sequential program data.
Introduction to Programming Program Data Syntax Rules All numbers are expected to be strings of ASCII characters. Thus, when sending the number 9, you would send a byte representing the ASCII code for the character “9” (which is 57). A three-digit number like 102 would take up three bytes (ASCII codes 49, 48, and 50). This is taken care of automatically when you include the entire instruction in a string.
Introduction to Programming Program Message Terminator Program Message Terminator The program instructions within a data message are executed after the program message terminator is received. The terminator may be either an NL (New Line) character, an EOI (End-Or-Identify) asserted in the GPIB interface, or a combination of the two. Asserting the EOI sets the EOI control line low on the last byte of the data message. The NL character is an ASCII linefeed (decimal 10).
2 Programming Getting Started Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming Getting Started This chapter explains how to set up the instrument, how to retrieve setup information and measurement results, how to digitize a waveform, and how to pass data to the controller. Languages for Programming Examples The programming examples in this guide are written in Agilent BASIC, C, or SICL C. 2–2 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming Getting Started Initialization Initialization To make sure the bus and all appropriate interfaces are in a known state, begin every program with an initialization statement. Agilent BASIC provides a CLEAR command which clears the interface buffer: CLEAR 707 ! initializes the interface of the instrument When you are using GPIB, CLEAR also resets the oscilloscope’s parser. The parser is the program which reads in the instructions which you send it.
Programming Getting Started Autoscale Autoscale The AUTOSCALE feature performs a very useful function on unknown waveforms by setting up the vertical channel, time base, and trigger level of the instrument. The syntax for the autoscale function is: :AUTOSCALE Setting Up the Instrument A typical oscilloscope setup would set the vertical range and offset voltage, the horizontal range, delay time, delay reference, trigger mode, trigger level, and slope.
Programming Getting Started Example Program Example Program This program demonstrates the basic command structure used to program the oscilloscope. 10 20 30 40 50 60 70 80 90 100 110 120 130 140 150 CLEAR 707 OUTPUT 707;"*RST" OUTPUT 707;":TIMEBASE:RANGE 5E-4" OUTPUT 707;":TIMEBASE:DELAY 0" OUTPUT 707;":TIMEBASE:REFERENCE CENTER" OUTPUT 707;":CHANNEL1:PROBE X10" OUTPUT 707;":CHANNEL1:RANGE 1.6" OUTPUT 707;":CHANNEL1:OFFSET -.
Programming Getting Started Using the DIGitize Command Using the DIGitize Command The DIGitize command is a macro that captures data satisfying the specifications set up by the ACQuire subsystem. When the digitize process is complete, the acquisition is stopped. The captured data can then be measured by the instrument or transferred to the controller for further analysis. The captured data consists of two parts: the waveform data record and the preamble.
Programming Getting Started Using the DIGitize Command The following program example shows a typical setup: OUTPUT 707;":ACQUIRE:TYPE AVERAGE" OUTPUT 707;":ACQUIRE:COMPLETE 100" OUTPUT 707;":WAVEFORM:SOURCE CHANNEL1" OUTPUT 707;":WAVEFORM:FORMAT BYTE" OUTPUT 707;":ACQUIRE:COUNT 8" OUTPUT 707;":WAVEFORM:POINTS 500" OUTPUT 707;":DIGITIZE CHANNEL1" OUTPUT 707;":WAVEFORM:DATA?" This setup places the instrument into
Programming Getting Started Receiving Information from the Instrument Receiving Information from the Instrument After receiving a query (command header followed by a question mark), the instrument interrogates the requested function and places the answer in its output queue. The answer remains in the output queue until it is read or another command is issued. When read, the answer is transmitted across the interface to the designated listener (typically a controller).
Programming Getting Started String Variables String Variables The output of the instrument may be numeric or character data depending on what is queried. Refer to the specific commands for the formats and types of data returned from queries. Express String Variables Using Exact Syntax In Agilent BASIC, string variables are case sensitive and must be expressed exactly the same each time they are used.
Programming Getting Started Numeric Variables Numeric Variables The following example shows the data being returned to a numeric variable: 10 20 30 40 OUTPUT 707;":CHANNEL1:RANGE?" ENTER 707;Rang PRINT Rang END After running this program, the controller displays: .8 2–10 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming Getting Started Definite-Length Block Response Data Definite-Length Block Response Data Definite-length block response data allows any type of device-dependent data to be transmitted over the system interface as a series of 8-bit binary data bytes. This is particularly useful for sending large quantities of data or 8-bit extended ASCII codes. The syntax is a pound sign ( # ) followed by a non-zero digit representing the number of digits in the decimal integer.
Programming Getting Started Multiple Queries Multiple Queries You can send multiple queries to the instrument within a single program message, but you must also read them back within a single program message. This can be accomplished by either reading them back into a string variable or into multiple numeric variables.
3 Programming over GPIB Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming over GPIB This section describes the GPIB interface functions and some general concepts. In general, these functions are defined by IEEE 488.1. They deal with general interface management issues, as well as messages which can be sent over the interface as interface commands. For more information on connecting the controller to the oscilloscope, see the documentation for the GPIB interface card you are using. 3–2 Artisan Technology Group - Quality Instrumentation ...
Programming over GPIB Interface Capabilities Interface Capabilities The interface capabilities of the oscilloscope, as defined by IEEE 488.1, are SH1, AH1, T5, L4, SR1, RL1, PP0, DC1, DT1, C0, and E2. Command and data concepts The interface has two modes of operation: · command mode · data mode The bus is in the command mode when the ATN line is true. The command mode is used to send talk and listen addresses and various bus commands, such as a group execute trigger (GET).
Programming over GPIB Addressing Addressing Set the instrument address by using the front panel controls on the oscilloscope after the GPIB interface has been installed on the rear panel of the oscilloscope. 1 Press Print/Utility , then press the I/O Menu softkey. 2 Press the Inst Addr softkey to select the instrument address. Increment the address by successively pressing the Inst Addr softkey. The address can also be incremented or decremented by turning the knob closest to the Cursors key.
Programming over GPIB Communicating over the bus Communicating over the bus Since GPIB can address multiple devices through the same interface card, the device address passed with the program message must include not only the correct interface select code, but also the correct instrument address. Interface Select Code (Selects Interface) Each interface card has a unique interface select code. This code is used by the controller to direct commands and communications to the proper interface.
Programming over GPIB Lockout Lockout You can use the SYSTem:LOCK ON command to disable front-panel control while a program is running. By default, the instrument accepts and executes bus commands, and the front panel is entirely active. Restore Front-Panel Control Cycling power also restores front panel control. With GPIB, the instrument is placed in the lockout mode by sending the local lockout command (LLO).
4 Programming over RS-232-C Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming over RS-232-C This section describes the interface functions and some general concepts of the RS-232-C. The RS-232-C interface on this instrument is Hewlett-Packard’s implementation of EIA Recommended Standard RS-232-C, “Interface Between Data Terminal Equipment and Data Communications Equipment Employing Serial Binary Data Interchange.” With this interface, data is sent one bit at a time and characters are not synchronized with preceding or subsequent data characters.
Programming over RS-232-C Interface Operation Interface Operation The oscilloscope can be programmed with a controller over RS-232-C using either a minimum three-wire or extended hardwire interface. The operation and exact connections for these interfaces are described in more detail in the following sections.
Programming over RS-232-C Minimum three-wire interface with software protocol Minimum three-wire interface with software protocol With a three-wire interface, the software (as compared to interface hardware) controls the data flow between the oscilloscope and the controller. This provides a much simpler connection between devices since you can ignore hardware handshake requirements.
Programming over RS-232-C Extended interface with hardware handshake Extended interface with hardware handshake With the extended interface, both the software and the hardware can control the data flow between the oscilloscope and the controller. This allows you to have more control of data flow between devices.
Programming over RS-232-C Extended interface with hardware handshake The TD (Transmit Data) line from the oscilloscope must connect to the RD (Receive Data) line on the controller. Likewise, the RD line from the oscilloscope must connect to the TD line on the controller. The RTS (Request To Send) line is an output from the oscilloscope which can be used to control incoming data flow.
Programming over RS-232-C Configuring the Interface Configuring the Interface Set the baud rate and handshake protocol by using the front panel controls on the oscilloscope after the RS-232-C interface has been installed on the rear panel of the oscilloscope. 1 Press Print/Utility , then press the I/O Menu softkey. 2 To change the baud rate, press the Baud Rate softkey until the desired baud rate is displayed.
Programming over RS-232-C Interface Capabilities Interface Capabilities The baud rate, stop bits, parity, handshake protocol, and data bits must be configured exactly the same for both the controller and the oscilloscope to properly communicate over the RS-232-C bus.
Programming over RS-232-C Communicating over the RS-232-C bus Data Bits Data bits are the number of bits sent and received per character that represent the binary code of that character. Information is stored in bytes (8 bits at a time) in the oscilloscope. Data can be sent and received just as it is stored, without the need to convert the data. Communicating over the RS-232-C bus Each RS-232-C interface card has its own interface select code.
Programming over RS-232-C Lockout Command Lockout Command To lockout the front panel controls use the system command LOCK. When this function is on, all controls (except the power switch) are entirely locked out. Local control can only be restored by sending the command :SYSTEM:LOCK OFF. Restoring Local Control Cycling the power will also restore local control, but this will also reset certain RS-232-C states. 4–10 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.
5 Programming and Documentation Conventions Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming and Documentation Conventions This chapter covers conventions which are used in programming the instrument, as well as conventions used in the online Agilent 54600-Series Oscilloscopes Programmer’s Reference and the remainder of this manual. This chapter also contains a detailed description of the command tree and command tree traversal. 5–2 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Programming and Documentation Conventions Command Set Organization Command Set Organization The command set is divided into common commands, root level commands and sets of subsystem commands. Each of the groups of commands is described in the Agilent 54600-Series Oscilloscopes Programmer’s Reference, which is supplied as an online help file for Microsoft Windows. See chapter 8 for information on installing and using the help file. The commands are shown using upper and lowercase letters.
Programming and Documentation Conventions Command Set Organization Table 5-1 Alphabetic Command Cross-Reference Command Subsystem Where Used Command Subsystem Where Used Command Subsystem Where Used ALL ASTore AUToscale MEASure Root level Root level *ESR Common Root level CHANnel WAVeform MASK MEASure TRIGger WAVeform MEASure SEQuence TRIGger MASK MEASure BLANk BWLimit BYTeorder FAILmode FALLtime FIELd FORMat FREQuency NEXT NREJect NUMBer NWIDth CENTer CLEAR *CLS COLumn COMPlete CONNect CO
Programming and Documentation Conventions Command Set Organization Command Subsystem Where Used Command Subsystem Where Used Command Subsystem Where Used RANGe RANGe RANGe *RCL REFerence REFerence REJect RESet RISetime ROW *RST RUN CHANnel FUNCtion TIMebase Common FUNCtion TIMebase TRIGger SEQuence MEASure DISPlay Common Root level *STB STEP STOP Common SEQuence Root level VSTOp VTIMe VTOP MEASure MEASure MEASure Common FUNCtion XINCrement XORigin XREFerence WAVeform WAVeform WAVeform Common
Programming and Documentation Conventions The Command Tree The Command Tree The command tree shows all of the commands and the relationship of the commands to each other. The IEEE 488.2 common commands are not listed as part of the command tree since they do not affect the position of the parser within the tree. When a program message terminator (, linefeed - ASCII decimal 10) or a leading colon (:) is sent to the instrument, the parser is set to the “root” of the command tree.
Programming and Documentation Conventions The Command Tree : (root) *CLS *ESE *ESR *IDN *LRN *OPC *OPT *RCL *RST *SAV *SRE *STB *TRG *TST *WAI ASTore AUToscale BLANk DIGitize DITHer ERASe MENU MERGe PRINt RUN STATus STOP TER VAUToscale VIEW SYSTem: ACQuire: CHANnel: DISPlay: FUNCtion: MASK: DSP ERRor KEY LOCK SETup COMPlete COUNt POINts SETup TYPE BWLimit COUPling INPut * INVert MATH OFFSet PMODe * PROBe PROTect * RANGe SETup SKEW * VERNier COLumn CONNect DATA GRID INVerse LINE PALette *** P
Programming and Documentation Conventions The Command Tree Subsystem Commands Subsystem commands are grouped together under a common node of the command tree, such as the TIMEBASE commands. Only one subsystem may be selected at any given time. When the instrument is initially turned on, the command parser is set to the root of the command tree, therefore, no subsystem is selected. Tree Traversal Rules Command headers are created by traversing down the command tree.
Programming and Documentation Conventions The Command Tree Examples The OUTPUT statements in the examples are written using Agilent BASIC 5.0. The quoted string is placed on the bus, followed by a carriage return and linefeed (CRLF). Example 1 OUTPUT 707;":CHANNEL1:RANGE 0.5 ;OFFSET 0" The colon between CHANNEL1 and RANGE is necessary because CHANNEL1:RANGE is a compound command. The semicolon between the RANGE command and the OFFSET command is the required program message unit separator.
Programming and Documentation Conventions Truncation Rules Truncation Rules The truncation rule for the mnemonics used in headers and alpha arguments is: The mnemonic is the first four characters of the keyword unless: The fourth character is a vowel, then the mnemonic is the first three characters of the keyword. This rule is not used if the length of the keyword is exactly four characters. Some examples of how the truncation rule is applied to various commands are shown in the following table.
Programming and Documentation Conventions Infinity Representation Infinity Representation The representation of infinity is 9.9E+37. This is also the value returned when a measurement cannot be made. Sequential and Overlapped Commands IEEE 488.2 distinguishes between sequential and overlapped commands. Sequential commands finish their task before the execution of the next command starts. Overlapped commands run concurrently.
Programming and Documentation Conventions Notation Conventions and Definitions Notation Conventions and Definitions The following conventions and definitions are used in this manual and the online Agilent 54600-Series Oscilloscopes Programmer’s Reference in descriptions of remote operation: Conventions < > Angle brackets enclose words or characters that symbolize a program code parameter or an interface command. ::= “is defined as.
Programming and Documentation Conventions Program Examples Program Examples The program examples given for commands in the online Agilent 54600-Series Oscilloscopes Programmer’s Reference were written using the Agilent BASIC for Windows, C, and SICL C programming languages. The programs always assume the oscillscope is at address 7 and the interface is at address 7 for a program address of 707. If a printer is used, it is always assumed to be at address 701.
5–14 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
6 Status Reporting Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Status Reporting IEEE 488.2 defines data structures, commands, and common bit definitions for status reporting on the interface. There are also instrument-defined structures and bits. The bits in the status byte act as summary bits for the data structures residing behind them. In the case of queues, the summary bit is set if the queue is not empty. For registers, the summary bit is set if any enabled bit in the event register is set. The events are enabled with the corresponding event enable register.
Status Reporting Figure 6–1 Status Reporting Data Structures 6–3 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Status Reporting Bit Definitions MAV - message available. Indicates whether there is a response in the output queue. ESB - event status bit. Indicates if any of the conditions in the Standard Event Status Register are set and enabled. MSS - master summary status. Indicates whether the device has a reason for requesting service. This bit is returned for the *STB? query. RQS - request service. Indicates if the device is requesting service. This bit is returned during a serial poll.
Status Reporting Operation Complete (*OPC) The IEEE 488.2 structure provides one technique which can be used to find out if any operation is finished. The *OPC command, when sent to the instrument after the operation of interest, sets the OPC bit in the Standard Event Status Register when all pending device operations have finished. If the OPC bit and the RQS bit have been enabled, a service request is generated.
Status Reporting Serial Poll Serial Poll This oscilloscope supports the IEEE 488.1 serial poll feature. When a serial poll of the instrument is requested, the RQS bit is returned on bit 6 of the status byte. Using Serial Poll The service request can used by conducting a serial poll of all instruments on the bus. For this procedure, assume that there are two instruments on the bus: an oscilloscope at address 7 and a printer at address 1. It is assumed that you are operating on Interface Select Code 7.
Status Reporting Serial Poll After the serial poll is completed, the RQS bit in the oscilloscope Status Byte Register is reset if it was set. Once a bit in the Status Byte Register is set, it remains set until the status is cleared with a *CLS command, or the instrument is reset. If these bits do not get reset, they cannot generate another SRQ. 6–7 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
6–8 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
7 Installing and Using the Programmer’s Reference Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Installing and Using the Programmer’s Reference The Programmer’s Reference is supplied as an online help file readable with the Microsoft Windows help viewer. Sample programs for the oscilloscopes are included in the Examples subdirectory. This chapter explains how to install the help file on your system, discusses the text and program files, and explains how you can get the programs and help file via the Internet. 7–2 Artisan Technology Group - Quality Instrumentation ...
Installing and Using the Programmer’s Reference To install the help file under Microsoft Windows To install the help file under Microsoft Windows The help file requires Microsoft Windows 95/98/NT running on an IBM-compatible PC. The file uses the Microsoft Windows help viewer, WINHELP.EXE. 1 2 Insert the 3.5" floppy disk labeled “54600/01/02/03/10/15/16 Programmer’s Reference with Example Programs” into the floppy disk drive of your PC.
Installing and Using the Programmer’s Reference To get updated help and program files via the Internet To get updated help and program files via the Internet The latest versions of the help and example program files are available via the internet using your web browser or using ftp software. · Log on to your Internet service. Using your web browser 1 To connect using your web browser, type the following on the address line in your internet browser: ftp://ftp.cos.agilent.
Installing and Using the Programmer’s Reference To start the help file To start the help file · To open the help file under Microsoft Windows, double-click the “Programmer’s Reference” icon in the “Agilent 54600-Series Oscilloscopes Programmer’s Reference” program group in the Program Manager. The help file requires the program WINHELP.EXE for Microsoft Windows95/98/NT. The properties for the Program Manager icon are set to expect this file in the Windows directory.
Installing and Using the Programmer’s Reference To navigate through the help file To navigate through the help file · Navigate through the help file by clicking on highlighted text and buttons. See your Microsoft Windows documentation for more information, or select Help | How to Use Help in the Help window. 7–6 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
8 Programmer’s Quick Reference Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.
Introduction The Programmer’s Quick Reference provides the commands and queries with their corresponding arguments and returned formats for the Agilent 54600-Series Oscilloscopes. The arguments for each command list the minimum argument required. The part of the command or query listed in uppercase letters refers to the short form of that command or query. The long form is the combination of the uppercase and lowercase letters. Any optional parameters are listed at the end of each parameter listing.
Programmer’s Quick Reference Conventions Conventions The following conventions used in this guide include: <> Indicates that words or characters enclosed in angular brackets symbolize a program code parameter or an GPIB command. ::= "is defined as." ::= indicates that can be replaced by in any statement containing . | "or" Indicates a choice of one element from a list. For example, | indicates or but not both. ...
Programmer’s Quick Reference Commands and Queries Commands and Queries The following tables facilitate easy access to each command and query for the Agilent 54600-Series Oscilloscopes. The commands and queries are divided into separate categories with each entry alphabetized. The arguments for each command list the minimum argument required. The part of the command or query listed in uppercase letters refers to the short form of that command or query.
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :ACQuire:COMPlete :ACQuire:COMPlete? ::= 0 to 100; an integer in NR1 format :ACQuire:COUNt :ACQuire:COUNT? ::= 8, 64, or 256; an integer in NR1 format n/a :ACQuire:POINts? For all models except 54615/16: 1 to 4000; an integer in NR1 format. For the 54615/16: 1 to 5000; an integer in NR1 format.
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :CHANnel:PROBe :CHANnel:PROBe? ::= X1, X10, X100 for 51600/01/02/03 X1, X10, X20, X100 for the 54610/15/16 ::= 1 or 2; an integer in NR1 format for 54600/03/10/15/16 1, 2, 3 or 4; an integer in NR1 format for the 54601/02 :CHANnel:PROTect {OFF | ON} :CHANnel:PROTect? {OFF | ON} ::= 1 or 2; an integer in NR1 format :CHANnel:RANGe :CHANnel:
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :DISPlay:GRID {ON | OFF | SIMPle | TV} :DISPlay:GRID? {ON | OFF | SIMPle | TV} :DISPlay:INVerse {ON | OFF} :DISPlay:INVerse? {ON | OFF} :DISPlay:LINE n/a ::= any series of ASCII characters enclosed in quotation marks :DISPlay:PALette :DISPlay:PALette? ::= 0 through 6; an integer in NR1 format :DISPlay:PIXel , , :DISPlay:PIXel? ,
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns n/a :DISPlay:SETup? :DISPlay:ROW ; ::= 1...20; an integer in NR1 format COLumn ; ::= 0...
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns n/a :EXTernal:SETup? For the 54610: EXTernal:OFFSet ; COUPling {DC | AC | GND}; PROBe {X1 | X10 | X20 | X100}; PMODe {AUTo | MANual}; INPut {FIFTy | ONEMeg}; PROTect {OFF | ON}; SKEW For the 54615/16: EXTernal:COUPling {DC | AC | GND}; PROBe {X1 | X10 | X20 | X100}; PMODe {AUTo | MANual}; INPut {FIFTy | ONEMeg}; PROTect {OFF | ON} :EXTernal:SKEW :EXTernal:SKEW?
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns n/a *IDN? HEWLETT-PACKARD,, 0, X.X ::= the model number of the instrument ::= the software revision of the instrument n/a *LRN? ::= a maximum of 218 bytes of data in IEEE 488.2 # format :MASK:CREATe n/a n/a :MASK:DATA :MASK:DATA? ::= block header that contains the ASCII characters #8000998 and is sent prior to the data.
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :MEASure:FALLtime :MEASure:FALLtime? ::= time in seconds between the 10% and 90% voltage levels in NR3 format :MEASure:FREQuency :MEASure:FREQuency? ::= frequency in Hertz in NR3 format :MEASure:LOWer :MEASure:LOWer? ::= the user-defined lower threshold in volts in NR3 format :MEASure:NWIDth :MEASure:NWIDth? ::= negative pulse width in seco
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :MEASure:UPPer :MEASure:UPPer? ::= the user-defined upper threshold in volts in NR3 format :MEASure:VAMPlitude :MEASure:VAMPlitude? ::= the amplitude of the selected waveform in volts in NR3 format :MEASure:VAVerage :MEASure:VAVerage? ::= calculated average voltage in NR3 format :MEASure:VBASe :MEASure:VBASe? ::= voltage at the base of the
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :MENU :MENU? ::= the following: Menu No menu selected Channel 1 Channel 2 Channel 3 (54601/02) External Trigger (54610/15/16) Channel 4 (54601/02) Math Trigger source 6 Trigger mode 7 Trigger slope 8 Main/delayed (horizontal) Time measurements Voltage measurements Cursors Trace Setup Display Utility/Print Number 0 1 2 3 3 4 5 9 10 11 12 13 14 15 16 :MERGe n/a
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :SEQuence:SETup {MASK | STEP}, , :SEQuence:SETup? {MASK | STEP}, MASK ::= an individual mask sent to the setup string. STEP ::= an individual step sent to the setup string. ::= the mask number or step number sent to the setup string. ::= the type of setup to be sent or returned: For individual masks, ::= #800001000. For individual steps, ::= #800000244.
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :STOP n/a n/a :SYSTem:DSP n/a ::= quoted ASCII string n/a :SYSTem:ERRor? ::= an integer error code See error values in the online Programmer’s Reference. :SYSTem:KEY :SYSTem:KEY? ::= -1 to 16, or 19 to 50; an integer See key code values in the online Programmer’s Reference.
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :TRACe:MODE {ON | OFF} :TRACe:MODE? ::= 1 to 100 ::= {ON | OFF} :TRACe:SAVE n/a ::= the trace memory number (1 to 100).
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns :TRIGger:SOURce
Programmer’s Quick Reference Commands and Queries Command Query Options and Query Returns n/a :WAVeform:PREamble? ::= , , , , , , , , , ::= an integer in NR1 format: 0 for ASCii format 1 for BYTE format 2 for WORD format ::= an integer in NR1 format: 0 for AVERage type 1 for NORMal type 2 for PEAK detect type ::= an integer in
Index A Addressing, 3–4 to 3–5 alpha argument, 5–10 Arguments, 1–5 B BASIC, 1–3 Baud rate, 4–7 to 4–8 Block data, 1–5, 2–11 C Cable RS-232-C, 4–3 carriage return, 5–9 Character data, 1–10 Character program data, 1–10 Clear To Send (CTS), 4–6 CME - command error, 6–4 Combining commands, 1–7 Command, 1–5 Common Commands, 5–6 Lockout, 4–10 Root Level Commands, 5–6 Subsystem Commands, 5–8 Command structure, 2–5 Command Tree, 5–6 to 5–9 Command Types, 5–6 Common command header, 1–6 common commands, 5–6 Communic
Index O OPC - operation complete, 6–4 Operation Complete, 6–5 Output command, 1–4 OUTPUT statement, 1–3 Overlapped Commands, 5–11 P Parallel Poll, 6–6 Parameters, 1–5 Parity, 4–8 Parser, 2–3 Program data, 1–5, 1–10 Program example, 2–5 program message, 5–9 Program message syntax, 1–4 Program message terminator, 1–12, 5–8 program message unit separator, 5–9 Program syntax, 1–4 programming conventions, 5–2 Protocol, 4–8 DTR (Data Terminal Ready), 4–8 XON/XOFF, 4–8 Q Query, 1–5, 1–8 Query command, 1–8 Query r
© Copyright Agilent Technologies 1995-1996, 2001 All Rights Reserved. Microsoft is a registered trademark of Microsoft Corporation. Reproduction, adaptation, or translation without prior written permission is prohibited, except as allowed under the copyright laws. Restricted Rights Legend. Use, duplication or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.
Product Warranty This Agilent Technologies product has a warranty against defects in material and workmanship for a period of three years from date of shipment. During the warranty period, Agilent Technologies will, at its option, either repair or replace products that prove to be defective. For warranty service or repair, this product must be returned to a service facility designated by Agilent Technologies.
Artisan Technology Group is your source for quality new and certified-used/pre-owned equipment • FAST SHIPPING AND DELIVERY • TENS OF THOUSANDS OF IN-STOCK ITEMS • EQUIPMENT DEMOS • HUNDREDS OF MANUFACTURERS SUPPORTED • LEASING/MONTHLY RENTALS • ITAR CERTIFIED SECURE ASSET SOLUTIONS SERVICE CENTER REPAIRS Experienced engineers and technicians on staff at our full-service, in-house repair center WE BUY USED EQUIPMENT Sell your excess, underutilized, and idle used equipment We also offer credit for buy-back