Notice Hewlett-Packard to Agilent Technologies Transition This documentation supports a product that previously shipped under the HewlettPackard company brand name. The brand name has now been changed to Agilent Technologies. The two products are functionally identical, only our name has changed. The document still includes references to Hewlett-Packard products, some of which have been transitioned to Agilent Technologies.
Contacting Agilent By internet, phone, or fax, get assistance with all your test and measurement needs. Table 1-1 Contacting Agilent Online assistance: www.agilent.
Programming Guide HP 83711A/12A and HP 83711B/12B Synthesized CW Generators
HP part number: 83711-90132 Printed in USA April, 1995 Supersedes 5960-7089 Notice. The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including but not limited to, the implied warranties of merchantability and tness for a particular purpose.
The HP 83711A/12A and HP 83711B/12B Synthesized CW Generators The HP 83711A/12A and HP 83711B/12B Synthesized CW Generators are referred to as \synthesizers" throughout this manual. The HP 83711A/11B has a carrier frequency range of 1 GHz to 20 GHz and the HP 83712A/12B has a carrier frequency range of 10 MHz to 20 GHz. Complete speci cation information can be found in Chapter 4 in the HP 83711A/12A and HP 83711B/12B Synthesized CW Generators User's Guide.
In This Book This book provides information about the various commands used in programming the synthesizer, error messages, and regulatory information. Information is divided into chapters as follows: Chapter 1, \Getting Started Programming," contains general HP-IB information, introduces the Standard Commands for Programmable Instruments (SCPI), and provides example programs. Chapter 2, \Programming Commands," contains entries on all of the programming commands used by the synthesizer.
Contents 1. Getting Started Programming HP-IB General Information . . . . . . . . . . Interconnecting Cables . . . . . . . . . . . Instrument Addresses . . . . . . . . . . . HP-IB Instrument Nomenclature . . . . . . Listener . . . . . . . . . . . . . . . . Talker . . . . . . . . . . . . . . . . . Controller . . . . . . . . . . . . . . . Programming the Synthesizer . . . . . . . . HP-IB Command Statements . . . . . . . . Abort . . . . . . . . . . . . . . . . . .
Forgiving Listening and Precise Talking Types of Commands . . . . . . . . . . . . . . . . . . . . . . Subsystem Command Trees . . . . . . . . . . . The Command Tree Structure . . . . . . . . Paths Through the Command Tree . . . . . . More About Commands . . . . . . . . . . . . Query and Event Commands . . . . . . . . . Implied Commands . . . . . . . . . . . . . Optional Parameters . . . . . . . . . . . . . Program Message Examples . . . . . . . . . . Example 1 . . . . . . . . . . . . . . . . .
Saving and Recalling States, Example Program 5 . . . Program Comments . . . . . . . . . . . . . . . . . Related Documents . . . . . . . . . . . . . . . . . 2. Programming Commands Command Syntax . . . . . . . . . . . . . . . . . . 2a. Automatic Level Control Commands 2b. Carrier Commands 2c. Instrument Information Commands [SOURce[1]:]POWer:ALC:PMETer . . . Query Syntax . . . . . . . . . . . See Also . . . . . . . . . . . . . [SOURce[1]:]POWer:ALC:PMETer:STEP Query Syntax . . . . . . . . . . .
*TST? (Self-Test Query) . . . . . . . . . . . . . . . 2d. Instrument State Commands 2e. Level Correction Commands *LRN? (Learn Device Setup Query) See Also . . . . . . . . . . . MEMory:RAM:INITialize . . . . See Also . . . . . . . . . . . *RCL (Recall Command) . . . . . See Also . . . . . . . . . . . *RST (Reset Command) . . . . . See Also . . . . . . . . . . . *SAV (Save Command) . . . . . See Also . . . . . . . . . . . SYSTem:PRESet . . . . . . . . See Also . . . . . . . . . . .
Query Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2e-17 2e-18 2e-19 2e-19 2e-20 2e-21 2e-22 2e-22 2e-23 2e-24 2e-24 See Also . . . . . . . . . . . . . . . . . . . . . . . [SOURce[1]:]CORRection:CSET:STATe . Query Syntax . . . . . . . . . . . . See Also . . . . . . . . . . . . . . [SOURce[1]:]CORRection[:STATe] . . . . Query Syntax . . . . . . . . . . . . See Also . . . . .
2h. Power Level Commands [SOURce[1]:]POWer[:LEVel] . . . Query Syntax . . . . . . . . . See Also . . . . . . . . . . . [SOURce[1]:]POWer[:LEVel]:STEP Query Syntax . . . . . . . . . See Also . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2h-3 2h-5 2h-5 2h-6 2h-7 2h-7 *OPC (Operation Complete) . . . . . Query Syntax . . . . . . . . . . . See Also . . . . . . . . . . . . .
2k. Status Register Commands The Status Register System . . . General Status Group Model . Condition Register . . . . Negative Transition Register Positive Transition Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable Register . . . . . . . . . . . . . Synthesizer Status Groups . . . . . . . . . The Status Byte Group . . . . . . . . . The Standard Event Status Group . . . . . The Standard Operation Status Group . . .
See Also . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2k-32 2k-33 2k-34 2k-35 2k-36 2k-37 2k-38 2k-39 2k-40 2k-42 2k-43 2k-45 2k-45 2k-46 2k-48 2k-48 2k-49 2k-50 Error Messages List . . . . . . . . . . . . . . . . . Messages . . . . . . . . . . . . . . . . . . . . . . 3-3 3-5 STATus:PRESet . . . . . . . . . . . . . . . . . . . . . See Also . . . . . . . . . . . STATus:QUEStionable:CONDition? See Also . . . . . . . . . . . STATus:QUEStionable:ENABle . . Query Syntax . . . .
5. Legal and Regulatory Information SCPI Conformance . . . Certi cation . . . . . . Regulatory Information Warranty . . . . . . . . Limitation of Warranty Exclusive Remedies . . Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figures 1-1. 1-2. 1-3. 1-4. 1-5. 1-6. 1-7. 1-8. 2k-1. 2k-2. HP-IB Connector and Cable . . . . . . . . . SCPI Command Types . . . . . . . . . . . A Simpli ed Command Tree . . . . . . . . Proper Use of the Colon and Semicolon . . . Simpli ed Program Message Syntax . . . . . SCPI Simpli ed Subsystem Command Syntax . Simpli ed Common Command Syntax . . . . Simpli ed Response Message Syntax . . . . . Status Register System Hierarchy . . . . . . General Status Group Model . . . . . . . . . . . . . . . . . . .
1 Getting Started Programming
Getting Started Programming HP-IB, the Hewlett-Packard Interface Bus, is the instrument-to-instrument communication system between the Synthesizer and up to 14 other instruments. Any instrument having HP-IB capability can be interfaced to the Synthesizer, including non-HP instruments that have \GP-IB," \IEEE-488," \ANSI MC1.1," or \IEC-625" capability (these are common generic terms for HP-IB; all are electrically equivalent although IEC-625 uses a unique connector).
HP-IB General Information Interconnecting Cables The HP-IB connector allows the synthesizer to be connected to any other instrument or device on the interface bus. All HP-IB instruments can be connected with HP-IB cables and adapters. These cables are shown in Figure 1-1. The adapters are principally extension devices for instruments that have recessed or crowded HP-IB connectors. Figure 1-1.
Getting Started Programming HP-IB General Information Table 1-1. HP-IB Interface Cables Available HP-IB Cable Part Numbers Lengths HP 10833A 1m (3.3 ft) HP 10833B 2m (6.6 ft) HP 10833C 4m (13.2 ft) HP 10833D 0.5m (1.6 ft) As many as fourteen HP-IB instruments can be connected to the synthesizer ( fteen total instruments in the system).
Getting Started Programming HP-IB General Information T5: Talker; capable of basic talker, serial poll, and unaddress if MLA. TE0 Talker, Extended address; no capability. L3 Listener, capable of basic listener, and unaddress if MTA. LE0 Listener, Extended address; no capability. SR1 Service Request, complete capability. RL1 Remote Local, complete capability. PP0 Parallel Poll, no capability. DC1 Device Clear, complete capability. DT0 Device Trigger, complete capability.
Getting Started Programming HP-IB General Information HP-IB Instrument Nomenclature An HP-IB instrument is categorized as a \listener," \talker," or \controller," depending on its current function in the network. Listener A listener is a device capable of receiving data or commands from other instruments. Any number of instruments in the HP-IB network can be listeners simultaneously. Talker A talker is a device capable of transmitting data or commands to other instruments.
Getting Started Programming HP-IB General Information HP-IB Command Statements Command statements form the nucleus of HP-IB programming; they are understood by all instruments in the network and, when combined with the programming language codes, they provide all management and data communication instructions for the system. An explanation of the eight fundamental command statements follows.
Getting Started Programming HP-IB General Information Abort Abort abruptly terminates all listener/talker activity on the interface bus, and prepares all instruments to receive a new command from the controller. Typically, this is an initialization command used to place the bus in a known starting condition. The syntax is: where the interface select code is the computer's HP-IB I/O port, which is typically port 7.
Getting Started Programming HP-IB General Information Remote Remote causes an instrument to change from local control to remote control. In remote control, the front panel keys are disabled (except for the 4LOCAL5 key and the POWER or LINE switch), and the REMOTE annunciator is lit. The syntax is: where the device selector is the address of the instrument appended to the HP-IB port number.
Getting Started Programming HP-IB General Information Local Lockout LOCAL LOCKOUT can be used in conjunction with REMOTE to disable the front panel 4LOCAL5 key. With the 4LOCAL5 key disabled, only the controller (or a hard reset by the POWER switch) can restore local control. The syntax is: A BASIC example 10 REMOTE 719 20 LOCAL LOCKOUT 7 Local LOCAL is the complement to REMOTE, causing an instrument to return to local control with a fully enabled front panel.
Getting Started Programming HP-IB General Information Clear CLEAR causes all HP-IB instruments, or addressed instruments, to assume a \cleared" condition, with the de nition of \cleared" being unique for each device. For the synthesizer: 1. All pending output-parameter operations are halted. 2. The parser (the software that interprets the programming codes) is reset, and now expects to receive the rst character of a programming code.
Getting Started Programming HP-IB General Information Output OUTPUT is used to send function commands and data commands from the controller to the addressed instrument. The syntax is: where USING is a secondary command that formats the output in a particular way, such as a binary or ASCII representation of numbers.
Getting Started Programming HP-IB General Information A BASIC example Related statements used by some computers 100 OUTPUT 719; "programming codes" CONTROL CONVERT IMAGE IOBUFFER TRANSFER 1-13
Getting Started Programming HP-IB General Information Enter ENTER is the complement of OUTPUT, and is used to transfer data from the addressed instrument to the controller. The syntax is: ENTER is always used in conjunction with OUTPUT, such as: 100 OUTPUT 719; " . . . programming codes . . . " 110 ENTER 719; " . . . response data . . . " ENTER statements are commonly formatted, which requires the secondary command USING and the appropriate image items.
Getting Started Programming HP-IB General Information NOTE Be careful when using byte-counting image speci ers. If the requested number of bytes does not match the actual number available, data might be lost, or the program might enter an endless wait state. The suppression of the EOI sequence is frequently necessary to prevent a premature termination of the data input. When not speci ed, the typical EOI termination occurs when an ASCII LF (line feed) is received.
Getting Started with SCPI This section of Chapter 1 describes the use of the Standard Commands for Programmable Instruments language (SCPI). This section explains how to use SCPI commands in general. This section presents only the basics of SCPI. If you want to explore the topic in greater depth, see the paragraph titled, \Related Documents.
De nitions of Terms You need a general understanding of the terms listed below before you continue. controller A controller is any computer used to communicate with a SCPI instrument. A controller can be a personal computer, a minicomputer, or a plug-in card in a card cage. Some intelligent instruments can also function as controllers. instrument An instrument is any device that implements SCPI. Most instruments are electronic measurement or stimulus devices, but this is not a requirement.
Getting Started Programming De nitions of Terms Standard Notation This section uses several forms of notation that have speci c meaning. Command Mnemonics Many commands have both a long and a short form, and you must use either one or the other (SCPI does not accept a combination of the two). Consider the FREQuency command,for example. The short form is FREQ and the long form is FREQUENCY (this notation style is a shorthand to document both the long and short form of commands).
Getting Started Programming De nitions of Terms Command Examples Command examples look like this: :FREQuency:CW? This example tells you to put the string :FREQuency:CW? in the output statement appropriate to your application programming language. If you encounter problems, study the details of how the output statement handles message terminators such as . If you are using simple OUTPUT statements in HP BASIC, this is taken care of for you.
Essentials for Beginners This section discusses elementary concepts critical to rst-time users of SCPI. Read and understand this section before continuing. This section includes the following topics: Program and Response These paragraphs introduce the basic types Messages of messages sent between instruments and controllers. Subsystem Command Trees These paragraphs describe the tree structure used in subsystem commands.
Getting Started Programming Essentials for Beginners Program and Response Messages To understand how your instrument and controller communicate using SCPI, you must understand the concepts of program and response messages. Program messages are the formatted data sent from the controller to the instrument. Conversely, response messages are the formatted data sent from the instrument to the controller. Program messages contain one or more commands, and response messages contain one or more responses.
Getting Started Programming Essentials for Beginners set of commands that roughly corresponds to a functional block inside the instrument. For example, the POWer subsystem contains commands for power generation, while the STATus subsystem contains commands for accessing status registers. Figure 1-2. SCPI Command Types The remaining paragraphs in this subsection discuss subsystem commands in more detail.
Getting Started Programming Essentials for Beginners Subsystem Command Trees The Command Tree Structure Most programming tasks involve subsystem commands. SCPI uses a hierarchical structure for subsystem commands similar to the le systems on most computers. In SCPI, this command structure is called a command tree. Figure 1-3. A Simpli ed Command Tree In the command tree shown in Figure 1-3, the command closest to the top is the root command, or simply the root.
Getting Started Programming Essentials for Beginners Power On and Reset After power is cycled or after *RST, the current path is set to the root. Message Terminators A message terminator, such as a character, sets the current path to the root. Many programming languages have output statements that send message terminators automatically. The paragraph titled, \Details of Commands and Responses," later in this chapter, discusses message terminators in more detail.
Getting Started Programming Essentials for Beginners Figure 1-4. Proper Use of the Colon and Semicolon Figure 1-4 shows examples of how to use the colon and semicolon to navigate e ciently through the command tree. Notice how proper use of the semicolon can save typing.
Getting Started Programming Essentials for Beginners More About Commands Query and Event Commands You can query any value that you can set. For example, the presence of the synthesizer FREQuency:STEP command implies that a FREQuency:STEP? also exists. If you see a command ending with a question mark, it is a query only command. Some commands are events, and cannot be queried. An event has no corresponding setting if it causes something to happen inside the instrument at a particular instant.
Getting Started Programming Essentials for Beginners Program Message Examples The following parts of the synthesizer SCPI command set will be used to demonstrate how to create complete SCPI program messages: :FREQuency [:CW] :STEP :POWER [:LEVel] Example 1 "FREQuency:CW 5 GHZ; STEP 2 GHZ" The command is correct and will not cause errors. It is equivalent to sending: "FREQuency:CW 5 GHZ; :FREQuency:STEP 2 GHZ". Example 2 "FREQuency 5 GHZ; :STEP 2 GHZ" This command results in a command error.
Getting Started Programming Essentials for Beginners Example 3 "FREQuency:STEP 1 GHZ; FREQuency:CW 5 GHZ" This command results in a command error. The FREQ:CW portion of the command is missing a leading colon. The path level is dropped at each colon until it is in the FREQ:STEP subsystem. So when the FREQ:CW command is sent, it causes confusion because no such node occurs in the FREQ:STEP subsystem. By adding a leading colon, the current path is reset to the root.
Getting Started Programming Essentials for Beginners Reading Instrument Errors When debugging a program, you may want to know if an instrument error has occurred. Some instruments can display error messages on their front panels. If your instrument cannot do this, you can put the following code segment in your program to read and display error messages.
Details of Commands and Responses This section describes the syntax of SCPI commands and responses. It provides many examples of the data types used for command parameters and response data. The following topics are explained: Program Message These paragraphs explain how to properly construct Syntax the messages you send from the computer to instruments. Response Message These paragraphs discuss the format of messages sent from instruments to the computer.
Getting Started Programming Details of Commands and Responses Program Message Syntax These program messages contain commands combined with appropriate punctuation and program message terminators. Figure 1-5. Simpli ed Program Message Syntax As Figure 1-5 shows, you can send common commands and subsystem commands in the same message. If you send more than one command in the same message, you must separate them with a semicolon.
Getting Started Programming Details of Commands and Responses SCPI Subsystem Command Syntax Figure 1-6. SCPI Simpli ed Subsystem Command Syntax As Figure 1-6 shows, there must be a between the last command mnemonic and the rst parameter in a subsystem command. This is one of the few places in SCPI where is required. Note that if you send more than one parameter with a single command, you must separate adjacent parameters with a comma.
Getting Started Programming Details of Commands and Responses Common Command Syntax Figure 1-7. Simpli ed Common Command Syntax As with subsystem commands, use a to separate a command mnemonic from subsequent parameters. Separate adjacent parameters with a comma. Parameter types are explained later in this subsection.
Getting Started Programming Details of Commands and Responses Response Message Syntax Figure 1-8. Simpli ed Response Message Syntax Response messages can contain both commas and semicolons as separators. When a single query command returns multiple values, a comma separates each data item. When multiple queries are sent in the same message, the groups of data items corresponding to each query are separated by a semicolon.
Getting Started Programming Details of Commands and Responses SCPI Data Types These paragraphs explain the data types available for parameters and response data. They list the types available and present examples for each type. SCPI de nes di erent data formats for use in program messages and response messages. It does this to accommodate the principle of forgiving listening and precise talking.
Getting Started Programming Details of Commands and Responses dictionary in Chapter 2 generally contains information about data types for individual commands. The following paragraphs explain each parameter and response data type in more detail. Parameter Types Numeric Parameters Numeric parameters are used in both subsystem commands and common commands. Numeric parameters accept all commonly used decimal representations of numbers including optional signs, decimal points, and scienti c notation.
Getting Started Programming Details of Commands and Responses Extended Numeric Parameters Most subsystems use extended numeric parameters to specify physical quantities. Extended numeric parameters accept all numeric parameter values and other special values as well. All extended numeric parameters accept MAXimum and MINimum as values. Other special values, such as UP and DOWN may be available as documented in Chapter 2. Note that MINimum and MAXimum can be used to set or query values.
Getting Started Programming Details of Commands and Responses Discrete Parameters Use discrete parameters to program settings that have a nite number of values. Discrete parameters use mnemonics to represent each valid setting. They have a long and a short form, just like command mnemonics. You can used mixed upper and lower case letters for discrete parameters.
Getting Started Programming Details of Commands and Responses Response Data Types Real Response Data A large portion of all measurement data are formatted as real response data. Real response data are decimal numbers in either xed decimal notation or scienti c notation. In general, you do not need to worry about the rules for formatting real data, or whether xed decimal or scienti c notation is used. Most high level programming languages that support instrument I/O handle either type transparently.
Getting Started Programming Details of Commands and Responses Discrete Response Data Discrete response data are similar to discrete parameters. The main di erence is that discrete response data return only the short form of a particular mnemonic, in all upper case letters. Examples of discrete response data: INTernal DIODe String Response Data level internally level using an external diode String response data are similar to string parameters.
Programming Typical Measurements This section illustrates how the general SCPI concepts presented in previous sections apply to programming real measurements. To introduce you to programming with SCPI, we must list the commands for the synthesizer. We will begin with a simpli ed example. Using the Example Programs The example programs are interactive. They require active participation by the operator.
Getting Started Programming Programming Typical Measurements HP-IB Check, Example Program 1 This rst program is to verify that the HP-IB connections and interface are functional. Connect a controller to the synthesizer via an HP-IB cable. Clear and reset the controller and type in the following program: 10 Synthesizer =719 20 ABORT 7 30 LOCAL Synthesizer 40 CLEAR Synthesizer 50 REMOTE Synthesizer 60 CLS 70 PRINT "The synthesizer should now be in REMOTE." 80 PRINT "Verify that the 'RMT' annunciator is on.
Getting Started Programming Programming Typical Measurements Local Lockout Demonstration, Example Program 2 When the synthesizer is in REMOTE mode, all the front panel keys are disabled except the LOCAL key. But, when the LOCAL LOCKOUT command is set on the bus, even the LOCAL key is disabled. The LOCAL command, executed from the controller, is then the only way to return all (or selected) instruments to front panel control. Continue example program 1.
Getting Started Programming Programming Typical Measurements Program Comments 90 to 120: 130: 140: 150 to 190: 200: 210 to 230: 1-44 Print a message on the computer's display, then pause. Place the synthesizer into REMOTE. Place the synthesizer into LOCAL LOCKOUT mode. Print a message on the computer's display, then pause. Return the synthesizer to local control. Print a message on the computer's display.
Getting Started Programming Programming Typical Measurements Internally Leveled CW Signal, Example Program 3 In the following example, an internally leveled, CW signal is generated at a frequency of 2.000203 GHz with a power level of 02.1 dBm. Clear and reset the controller and type in the following program: 10 Synthesizer=719 20 ABORT 7 30 LOCAL 7 40 CLEAR Synthesizer 50 REMOTE Synthesizer 60 OUTPUT Synthesizer;"*RST" 70 OUTPUT Synthesizer;"POW:ALC:SOUR INT" 80 OUTPUT Synthesizer;"FREQuency 2.
Getting Started Programming Programming Typical Measurements Level Correction Routine, Example Program 4 The following example demonstrates how to gather level correct data externally, then load the collected data into one of the synthesizer level correct tables.
Getting Started Programming Programming Typical Measurements 290 FOR I=1 TO Points 300 Frequencies(I)=Current_freq 310 OUTPUT Synthesizer; "FREQ ";Current_freq;" GHZ" 320 OUTPUT Power_meter; "FR ";Current_freq;" GZ" 330 OUTPUT Power_meter; "TR2" 340 WAIT 5 350 ENTER Power_meter;Meter_reading 360 Losses(I)=Power_level-Meter_reading 370 Current_freq=Current_freq+Step_freq 380 NEXT I 390 OUTPUT Synthesizer; "MEM:TABL:SEL FDAT";TRIM$(VAL$(Table_num)) 400 ! 410 ! Store frequencies 420 ! 430 OUTPUT Synthesizer;
Getting Started Programming Programming Typical Measurements 80: 90: 100: 110: 120: 130: 140: 150: 160: 170: 180: 190: 200 to 220: 230: 240: 250: 260: 270: 280: 300: 310: 320: 330: 1-48 Set the synthesizer to its initial state for programming. Set the power meter to its initial state for programming. Dimension frequency array. Dimension correction factor array. Print a message on the computer display for entering the start frequency. Enter start frequency into variable Start freq.
Getting Started Programming Programming Typical Measurements 340: 350: 360: 370: 390: 430: 450: 460: 480: 520: 540: 550: 570: Wait ve seconds for power meter to stabilize. Enter current power meter reading into variable Meter reading. Store the correction factor into the Losses array. Increment the current frequency to the next frequency point to measure. Select a table for data storage. Command the synthesizer to load the following frequency points into table. Add a frequency point into the table.
Getting Started Programming Programming Typical Measurements Saving and Recalling States, Example Program 5 The complete front panel state may be saved for later use in non-volatile memories called registers 0 through 9. This can be done remotely as a part of a program.
Getting Started Programming Programming Typical Measurements Program Comments 10: 20 to 50: 60: 70: Assign the synthesizer's HP-IB address to a variable. Abort any HP-IB activity and initialize the HP-IB interface. Clear the computer's display. Set up a Synthesizer state. Note the combination of several commands into a single message.
Related Documents IEEE Standard 488.1-1987, IEEE Standard Digital Interface for Programmable Instrumentation. The International Institute of Electrical and Electronics Engineers, New York, NY, 1987. This standard de nes the technical details required to design and build an HP-IB interface (IEEE 488.1). This standard contains electrical speci cations and information on protocol that is beyond the needs of most programmers.
Getting Started Programming Related Documents chapter. This manual is the best reference on instrument I/O for HP BASIC programmers. Tutorial Description of the Hewlett-Packard Interface Bus Hewlett-Packard Company, 1987 This book provides a thorough overview of HP-IB basics for the HP-IB system designer, programmer, or user. NOTE To obtain a copy of either of these documents, contact the Hewlett-Packard representative listed in your telephone directory.
Getting Started Programming Related Documents
2 Programming Commands
Programming Commands This chapter contains detailed information on all the programming commands used by the synthesizer. The chapter is sub-divided into logical groupings of commands that are tabbed. For example, all programming commands pertaining to automatic level control are contained in one tabbed section. The individual commands are organized alphabetically within each section. The remainder of this chapter introduction contains information that pertains to all programming commands.
Command Syntax Following the heading for each programming command entry is a syntax statement showing the proper syntax for the command. An example syntax statement is shown below: 2 2 3 3 2 32 SOURce 1 : POWer :LEVel :IMMediate 8 9 incr > > 2 3 < MAXimum = :STEP :INCRement > : MINimum > ; DEFault 32 :AMPLitude 3 Syntax statements read from left to right and top to bottom.
Programming Commands Command Syntax
2a Automatic Level Control Commands
Automatic Level Control Commands This sub-chapter contains detailed information on all programming commands pertaining to automatic level control.
[SOURce[1]:]POWer:ALC:PMETer 2 2 3 3 2 SOURce 1 : POWer:ALC:PMETer :LEVel 8 9 pmeter > > > > > MAXimum > > > > > < = MINimum > > > UP > > > > > DOWN > > : ; DEFault 32 :AMPLitude 3 The \[SOURce[1]:]POWer:ALC:PMETer" command is used to enter the initial reading of the external power meter to the synthesizer for use during external power meter leveling. The parameters are as follows: pmeter Enters the initial reading of the external power meter to the synthesizer.
Automatic Level Control Commands [SOURce[1]:]POWer:ALC:PMETer If an initial power meter reading is entered that is outside of its allowable range, an error message will be generated and the parameter will be set to either its maximum or minimum limit. The preset value for the parameter is 0 dBm.
[SOURce[1]:]POWer:ALC:PMETer:STEP 2 2 3 3 2 3 2 SOURce 1 : POWer:ALC:PMETer :LEVel :STEP :INCRement 8 9 incr > > < = MAXimum MINimum > > : ; DEFault 3 The \[SOURce[1]:]POWer:ALC:PMETer:STEP" command selects the increment value for the entered initial power meter reading. The parameters are as follows: incr Sets the increment value for the initial power meter reading. The allowable range for the parameter is 0.01 dB to 130 dB when option 1E1 is installed or 0.
Automatic Level Control Commands [SOURce[1]:]POWer:ALC:PMETer:STEP Query Syntax 2 2 3 3 2 3 2 3 SOURce 1 : POWer:ALC:PMETer :LEVel :STEP :INCRement ? 3 MAXimum 4 MINimum 5 DEFault 2 Returned format: incr Where: incr ::= The current power meter reading increment value if no argument is speci ed. incr ::= The maximum power meter reading increment value that can be set if the MAXimum argument is speci ed.
[SOURce[1]:]POWer:ALC:SOURce 2 2 3 3 SOURce 1 : POWer:ALC:SOURce 8 9 < INTernal = : DIODe PMETer ; The \[SOURce[1]:]POWer:ALC:SOURce" command selects the type of leveling for output power automatic level control. The parameters are as follows: INTernal Selects internal leveling. DIODe Selects external diode detector leveling. PMETer Selects external power meter leveling.
Automatic Level Control Commands [SOURce[1]:]POWer:ALC:SOURce See Also 4EXT DIODE5 4EXT METER5 4INT LEVEL5 [SOURce[1]:]POWer:ALC:PMETer [SOURce[1]:]POWer[:LEVel] To Use External Diode Detector Leveling To Use External Power Meter Leveling 2a-8
2b Carrier Commands
Carrier Commands This sub-chapter contains detailed information on all programming commands pertaining to carrier control 2b-2
[SOURce[1]:]FREQuency[:CWj:FIXed] 2 2 3 3 2 SOURce 1 : FREQuency :CW|:FIXed 8 9 freq > > > > > > MAXimum > > > > < = 3 MINimum UP > > > > > DOWN : DEFault > > > > > ; The \[SOURce[1]:]FREQuency[:CWj:FIXed]" command sets the output frequency of the synthesizer. The parameters are as follows: freq Sets the synthesizer output frequency. MAXimum Sets the synthesizer output frequency to the maximum allowable value. MINimum Sets the synthesizer output frequency to the minimum allowable value.
Carrier Commands [SOURce[1]:]FREQuency[:CWj:FIXed] Query Syntax 2 2 3 MAXimum SOURce 1 : FREQuency :CW|:FIXed ? 4 MINimum 5 DEFault 2 3 3 2 3 Returned format: freq Where: freq ::= The current output frequency if no argument is speci ed. freq ::= The maximum output frequency that can be set if the MAXimum argument is speci ed. freq ::= The minimum output frequency that can be set if the MINimum argument is speci ed.
[SOURce[1]:]FREQuency[:CWj:FIXed]:STEP 2 2 3 3 2 3 2 SOURce 1 : FREQuency :CW|:FIXed :STEP :INCRement 8 9 incr > > < = MAXimum MINimum > > : ; DEFault 3 The \[SOURce[1]:]FREQuency[:CWj:FIXed]:STEP" command selects the increment value for the synthesizer output frequency. The parameters are as follows: incr Sets the increment value for output frequency. The allowable range (without option 1E8) for the parameter is 1 kHz to 19.99 GHz.
Carrier Commands [SOURce[1]:]FREQuency[:CWj:FIXed]:STEP Query Syntax 2 2 3 3 2 3 2 3 SOURce 1 : FREQuency :CW|:FIXed :STEP :INCRement ? 3 MAXimum 4 MINimum 5 DEFault 2 Returned format: incr Where: incr ::= The current output frequency increment value if no argument is speci ed. incr ::= The maximum output frequency increment value that can be set if the MAXimum argument is speci ed. incr ::= The minimum output frequency increment value that can be set if the MINimum argument is speci ed.
[SOURce[1]:]FREQuency:MULTiplier 2 2 3 3 SOURce 1 : FREQuency:MULTiplier 8 9 mult > > > > > > MAXimum > > > > < = MINimum UP > > > > > DOWN : DEFault > > > > > ; The \[SOURce[1]:]FREQuency:MULTiplier" command sets the multiplier value so that the synthesizer display will indicate the frequency at the output of an external frequency multiplier. The parameters are as follows: mult Sets the multiplier value. The allowable range for the parameter is 1 to 100.
Carrier Commands [SOURce[1]:]FREQuency:MULTiplier be aware that the entered frequency divided by the multiplier value (the frequency before multiplication) has a minimum resolution of 1 kHz (1 Hz for Option 1E8). As an example, assume a multiplier value of 2 has been entered and you attempt to enter a frequency of 4,000,001,000 Hz. The actual frequency that the synthesizer would need to generate would be 2,000,000,500 Hz.
Carrier Commands [SOURce[1]:]FREQuency:MULTiplier See Also [SOURce[1]:]FREQuency[:CWj:FIXed] [SOURce[1]:]FREQuency:MULTiplier:STEP To Generate Millimeter Signals 2b-9
[SOURce[1]:]FREQuency:MULTiplier:STEP 2 2 3 3 2 SOURce 1 : FREQuency:MULTiplier:STEP :INCRement 8 9 incr > > < = MAXimum MINimum > > : ; DEFault 3 The \[SOURce[1]:]FREQuency:MULTiplier:STEP" command selects the increment value for the external frequency multiplier value. The parameters are as follows: incr Sets the multiplier increment value. The allowable range for the parameter is 1 to 99. MAXimum Sets the multiplier increment value to its maximum allowable value.
Carrier Commands [SOURce[1]:]FREQuency:MULTiplier:STEP Query Syntax 2 2 3 3 2 3 SOURce 1 : FREQuency:MULTiplier:STEP :INCRement ? 3 MAXimum 4 MINimum 5 DEFault 2 Returned format: incr Where: incr ::= The current multiplier increment value if no argument is speci ed. incr ::= The maximum multiplier increment value that can be set if the MAXimum argument is speci ed. incr ::= The minimum multiplier increment value that can be set if the MINimum argument is speci ed.
Carrier Commands [SOURce[1]:]FREQuency:MULTiplier:STEP
2c Instrument Information Commands
Instrument Information Commands This sub-chapter contains detailed information on all programming commands pertaining to instrument-speci c information.
*IDN? (Identi cation Query) *IDN? The \*IDN?" query returns a string that contains the instrument model number, serial number, and rmware revision number. When the \*IDN?" query is received by the instrument, it returns the following string: HEWLETT-PACKARD,8371XX,ser no,REVXX.Y Where HP 8371XX is the instrument model number (either HP 83711A/12A or HP 83711B/12B), \ser no" is the instrument serial number, and \XX.Y" is the rmware revision number.
*OPT? (Option Identi cation Query) *OPT? The \*OPT?" query returns a list of the synthesizer option numbers. In response to the \*OPT?" query, the synthesizer will return a string in the following form: option#1,option#2,option#3,. . . . .option#n, The possible Synthesizer options returned with this command are shown in the following table. If the synthesizer contains none of the options stated in the following table, \0" will be returned.
OUTPut:IMPedance? 2 3 MAXimum 4 OUTPut:IMPedance? MINimum 5 DEFault The \OUTPut:IMPedance?" query returns the output impedance of the synthesizer RF OUTPUT connector. NOTE The synthesizer output impedance is not selectable, therefore, \+5.0000000000000E+001" will always be returned in response to this query. This query is provided for SCPI compatibility.
[SOURce[1]:]ROSCillator:SOURce? 2 2 3 3 SOURce 1 : ROSCillator:SOURce? The \[SOURce[1]:]ROSCillator:SOURce?" query returns the source of the synthesizer timebase reference. When the \[SOURce[1]:]ROSCillator:SOURce?" query is sent, the following is returned: Sour Where: Sour ::= \INT" if the synthesizer internal timebase reference is currently in use. Sour ::= \EXT" if an external timebase reference is currently in use.
SYSTem:ERRor? SYSTem:ERRor? The \SYSTem:ERRor?" query returns the oldest uncleared error number and error description from the synthesizer HP-IB error queue. NOTE The HP-IB error queue is separate from the front panel error queue (that is read by pressing the 4MSG5 key). Reading and clearing the HP-IB error queue has no e ect on the front panel error queue. When an error is read, it is cleared as long as the error condition no longer exists.
Instrument Information Commands SYSTem:ERRor? NOTE The HP-IB error queue returns the oldest error message when queried. Preset has no e ect on the HP-IB error queue; it is only cleared at power up, by sending the \*CLS" command, or by reading its entire contents.
SYSTem:VERSion? SYSTem:VERSion? The \SYSTem:VERSion?" query returns the SCPI (Standard Commands for Programmable Instruments) version number that the Synthesizer supports. When the \SYSTem:VERSion?" query is sent, the following is returned: vers Where: vers ::= The SCPI version number currently supported by the Synthesizer.
*TST? (Self-Test Query) *TST? The \*TST?" query causes the instrument to perform a self-test. No external equipment is required to run the instrument self-test. Prior to running the self-test, disconnect any equipment that is connected to the RF OUTPUT as the synthesizer might generate high output power during the self-test. When the self-test is complete, the synthesizer is set to the preset state. The result of the instrument self-test will be placed in the output queue.
2d Instrument State Commands
Instrument State Commands This sub-chapter contains detailed information on all programming commands pertaining to the state of the synthesizer.
*LRN? (Learn Device Setup Query) *LRN? The \*LRN?" query returns an HP-IB command that contains the current state of the synthesizer. The information returned in response to the \*LRN?" query can be stored in a string variable in computer memory. When the string is issued to the synthesizer, the instrument settings are changed back to the state when the \*LRN?" query was executed.
Instrument State Commands *LRN? (Learn Device Setup Query) See Also *RCL *RST *SAV 2d-4
MEMory:RAM:INITialize 2 MEMory:RAM:INITialize :ALL 3 The \MEMory:RAM:INITialize" command clears all of the synthesizer Random Access Memory (RAM). When the \MEMory:RAM:INITialize" command is sent, all user settings are set to the preset state, save/recall registers are erased, and level correction data is cleared. Sending the \MEMory:RAM:INITialize" command does not clear factory calibration data stored in the instrument EEPROM.
*RCL (Recall Command) *RCL register The \*RCL" command allows you to recall a previously stored instrument state from one of ten register locations. The parameter is as follows: register The number of the register where the desired instrument state has been stored. The number must be an integer from 0 to 9. If you attempt to recall an instrument state from a register location to which an instrument state had not been previously saved, the preset state is recalled.
*RST (Reset Command) *RST The \*RST" command sets the synthesizer to its initial state for programming.
*SAV (Save Command) *SAV register The \*SAV" command allows you to save the instrument state in one of ten register locations. The parameter is as follows: register The number of the register where the instrument state is to be stored. The number must be an integer from 0 to 9. All user settings that are a ected by preset will be saved. Level correction tables will not be saved.
SYSTem:PRESet SYSTem:PRESet The \SYSTem:PRESet" command sets the synthesizer to the preset state.
MEMory:CATalog[:ALL]? 2 3 MEMory:CATalog :ALL ? The \MEMory:CATalog[:ALL]?" query lists all level correction tables. This command always returns the following: 1604,0, \FDAT1,TABLe,401", \FDAT2,TABLe,401", \FDAT3,TABLe,401", \FDAT4,TABLe,401".
MEMory:CATalog:TABLe? MEMory:CATalog:TABLe? The \MEMory:CATalog:TABLe?" query lists all level correction tables. This command always returns the following: 1604,0, \FDAT1,TABLe,401", \FDAT2,TABLe,401", \FDAT3,TABLe,401", \FDAT4,TABLe,401".
Instrument State Commands MEMory:CATalog:TABLe?
2e Level Correction Commands
Level Correction Commands This sub-chapter contains detailed information on all programming commands pertaining to level correction.
MEMory:TABLe:FREQuency MEMory:TABLe:FREQuency 8 9 < freq,freq,freq,...freq = : MAXimum MINimum ; The \MEMory:TABLe:FREQuency" command is used to load the frequency points into the level correct table selected using the \MEMory:TABLe:SELect" command. The parameter is as follows: freq The frequency points that make up the frequency portion of a level correct table. Each \freq" parameter can be a numeric value or one of two optional parameters.
Level Correction Commands MEMory:TABLe:FREQuency NOTE The total number of frequency points loaded using this command must be identical to the number of correction factors loaded with the \MEMory:TABLe:LOSS[:MAGNitude]" command. If they aren't identical, an error message will be generated when you try to use the table to correct power at the RF OUTPUT connector.
Level Correction Commands MEMory:TABLe:FREQuency See Also MEMory:TABLe:FREQuency:POINts? MEMory:TABLe:LOSS[:MAGNitude] MEMory:TABLe:LOSS[:MAGNitude]:POINts? MEMory:TABLe:SELect To Use the Level Correct Routine 2e-5
MEMory:TABLe:FREQuency:POINts? MEMory:TABLe:FREQuency:POINts? MAXimum MINimum The \MEMory:TABLe:FREQuency:POINts?" query returns the number of frequency points loaded into the level correct table currently selected using the \MEMory:TABLe:SELect" command. When the \MEMory:TABLe:FREQuency:POINts?" query is sent, the following is returned: poin Where: poin ::= The number of frequency points currently loaded into the selected level correct table if no argument is speci ed.
MEMory:TABLe:LOSS[:MAGNitude] 2 MEMory:TABLe:LOSS :MAGNitude 8 9 cf,cf,cf,...cf < = 3 : MAXimum MINimum ; The \MEMory:TABLe:LOSS[:MAGNitude]" command is used to load the correction factors into the level correct table selected using the \MEMory:TABLe:SELect" command. The parameter is as follows: cf The correction factors that make up the correction factor portion of a level correct table. Each \cf" parameter can be a numeric value or one of two optional parameters.
Level Correction Commands MEMory:TABLe:LOSS[:MAGNitude] NOTE The total number of correction factors loaded using this command must be identical to the number of frequency points loaded with the \MEMory:TABLe:FREQuency" command. If they aren't identical, an error message will be generated when you try to use the table to correct power at the RF OUTPUT connector.
Level Correction Commands MEMory:TABLe:LOSS[:MAGNitude] See Also MEMory:TABLe:FREQuency MEMory:TABLe:FREQuency:POINts? MEMory:TABLe:LOSS[:MAGNitude]:POINts? MEMory:TABLe:SELect To Use the Level Correct Routine 2e-9
MEMory:TABLe:LOSS[:MAGNitude]:POINts? 2 3 MEMory:TABLe:LOSS :MAGNitude :POINts? MAXimum MINimum The \MEMory:TABLe:LOSS[:MAGNitude]:POINts?" query returns the number of correction factors loaded into the level correct table currently selected using the \MEMory:TABLe:SELect" command.
MEMory:TABLe:SELect MEMory:TABLe:SELect FDATtableno The \MEMory:TABLe:SELect" command selects the level correct table where level correct data will be loaded. The parameter is as follows: tableno The number of the level correct table where level correct data will be loaded. The number must be an integer from 1 to 4. This command selects one of four level correct tables where level correct data will be loaded using the \MEMory:TABLe:FREQuency" and \MEMory:TABLe:LOSS[:MAGNitude]" commands.
Level Correction Commands MEMory:TABLe:SELect Query Syntax MEMory:TABLe:SELect? Returned format: FDATtableno Where: tableno ::= The level correct table currently selected to be loaded with level correct data.
[SOURce[1]:]CORRection:CSET[:SELect] 2 2 3 3 2 3 SOURce 1 : CORRection:CSET :SELect FDATtableno The \[SOURce[1]:]CORRection:CSET[:SELect]" command selects the level correct table that is used to correct power at the synthesizer RF OUTPUT connector. The parameter is as follows: tableno The number of the level correct table that is used to correct power at the synthesizer RF OUTPUT connector. The number must be an integer from 1 to 4.
Level Correction Commands [SOURce[1]:]CORRection:CSET[:SELect] Query Syntax 2 2 3 3 2 3 SOURce 1 : CORRection:CSET :SELect ? Returned format: FDATtableno Where: tableno ::= The level correct table currently selected to correct power at the synthesizer RF OUTPUT connector.
[SOURce[1]:]CORRection:FLATness[:DATA] 2 2 3 3 2 SOURce 1 : CORRection :FLATness :DATA 8 freq,level,...freq,level 9 > > < = MAXimum MINimum > > : ; DEFault 3 The \[SOURce[1]:]CORRection:FLATness[:DATA]" command sets the user frequency and level correction values. These values must be sent in frequency, level correction pairs. The input frequency range is dependent upon installed options; the level correction range is 040 dB to +40 dB. For example: CORRection:FLATness 1e9,0.1,2e9,0.2,3e9,0.
Level Correction Commands [SOURce[1]:]CORRection:FLATness[:DATA] Query Syntax 2 2 3 MAXimum SOURce 1 : CORRection:FLATness :DATA ? 4 MINimum 5 DEFault 2 3 3 2 3 Returned format: freq,level Where: freq,level ::= The current frequency and level correction values if no argument is speci ed. freq,level ::= The maximum frequency and level correction values that can be set if the MAXimum argument is speci ed.
[SOURce[1]:]CORRection:FLATness:POINts 2 2 3 3 SOURce 1 : CORRection:FLATness:POINts 8 points > < MAXimum 9 > = > : MINimum > ; DEFault The \[SOURce[1]:]CORRection:FLATness:POINts" command sets the number of user frequency and level correction points (or pairs). The parameters are as follows: points Sets the number of user frequency and level correction points. MAXimum Sets the number of user frequency and level correction points to the maximum number.
Level Correction Commands [SOURce[1]:]CORRection:FLATness:POINts points ::= The maximum number of frequency and level correction pairs that can be set if the MAXimum argument is speci ed. points ::= The minimum number of frequency and level correction pairs that can be set if the MINimum argument is speci ed. points ::= The default (preset) number of frequency and level correction pairs if the DEFault argument is speci ed.
[SOURce[1]:]CORRection:CSET:STATe 2 2 3 3 SOURce 1 : CORRection:CSET:STATe ON OFF The \[SOURce[1]:]CORRection:CSET:STATe" command turns level correction on or o . The parameters are as follows: ON Turns level correction on. OFF Turns level correction o . Level correction must be turned on using this command and all corrections must be turned on using the \[SOURce[1]:]CORRection[:STATe]" command in order to turn the level correct function on. The preset condition for this command is o .
Level Correction Commands [SOURce[1]:]CORRection:CSET:STATe Where: state ::= \+1" if level correction is currently turned on. state ::= \+0" if level correction is currently turned o .
[SOURce[1]:]CORRection[:STATe] 2 2 3 3 2 SOURce 1 : CORRection :STATe 3 ON OFF The \[SOURce[1]:]CORRection[:STATe]" command turns all corrections on or o . NOTE This command is provided for SCPI compatibility only. In this version of the synthesizer, the only correction available is level correction. The parameters are as follows: ON Turns all corrections on. OFF Turns all corrections o .
Level Correction Commands [SOURce[1]:]CORRection[:STATe] Query Syntax 2 2 3 3 2 3 SOURce 1 : CORRection :STATe ? Returned format: state Where: state ::= \+1" if all corrections are currently turned on. state ::= \+0" if all corrections are currently turned o .
SYSTem:COMMunicate:PMETer:ADDRess SYSTem:COMMunicate:PMETer:ADDRess 8 9 < address = : MAXimum MINimum ; The \SYSTem:COMMunicate:PMETer:ADDRess" command allows you to change the HP-IB address that the synthesizer uses when communicating with an external power meter during the level correct routine. The parameters are as follows: address The HP-IB address of the external power meter. The valid address range is 00 to 30 (decimal). MAXimum Sets the power meter HP-IB address to its maximum allowable value.
Level Correction Commands SYSTem:COMMunicate:PMETer:ADDRess Query Syntax SYSTem:COMMunicate:PMETer:ADDRess? MAXimum MINimum Returned format: address Where: address ::= The current external power meter HP-IB address when no optional argument is speci ed. address ::= The maximum allowable power meter HP-IB address when the MAXimum argument is speci ed. address ::= The minimum allowable power meter HP-IB address when the MINimum argument is speci ed.
2f Macro Commands
Macro Commands This sub-chapter contains detailed information on all programming commands pertaining to macros.
*DMC (De ne Macro Command) *DMC "name","commands" The \*DMC" command allows you to create a macro that consists of any combination of synthesizer programming commands. The parameters are as follows: name The name for the macro. The name can consist of uppercase or lowercase alpha characters, numeric characters 0 through 9, or the underscore ( ). The name must begin with an alpha character and can be up to 255 characters long. commands The synthesizer programming commands to be de ned by the macro name.
*EMC (Enable Macros) *EMC 0 1 The \*EMC" command enables or disables macros created with the \*DMC" command. The parameters are as follows: 0 Disables macros created with the \*DMC" command. 1 Enables macros created with the \*DMC" command. The preset condition for the \*EMC" command is \0" (disabled). Query Syntax *EMC? Returned format: state Where: state ::= \+0" if macros are disabled or \+1" if macros are enabled.
Macro Commands *EMC (Enable Macros) See Also *DMC *GMC? *LMC? *PMC *RMC 2f-5
*GMC? (Get Macro Contents Query) *GMC? "name" The \*GMC" query returns the commands that are in a given macro de ned by the \*DMC" command. The parameter is as follows: name The name of the macro for which you want to get the list of commands. This macro must have been previously de ned with the \*DMC" command. The synthesizer returns the list of macro commands in IEEE 488.2 De nite Length Arbitrary Block Response Data format.
*LMC? (List Macro Query) *LMC? The \*LMC?" query returns a listing of the names of all macros that have been de ned by the \*DMC" command. In response to the \*LMC?" query, the synthesizer will return a list of macro names de ned. The macro names will be returned as string data separated by commas. If no macros have been de ned, the synthesizer will return the empty string ( \" ) in response to the \*LMC?" query.
MEMory:FREE:MACRo? MEMory:FREE:MACRo? The \MEMory:FREE:MACRo?" query returns two numbers. The rst is the number of bytes available for use in de ning new macros. The second is the number of bytes currently being used for existing macros.
*PMC (Purge Macros Command) *PMC The \*PMC" command purges all macros that have been de ned. The \*PMC" command purges all de ned macros. Purged macros are erased from memory and can not be recovered. To selectively purge certain macros, use the \*RMC" command.
*RMC (Remove Macro Command) *RMC "name" The \*RMC" command selectively purges a macro from the synthesizer memory. The parameter is as follows: name The name of the macro that you want to purge. This macro must have been previously de ned with the \*DMC" command. The \*RMC" command purges only the macro whose name is stated with the command. The purged macro is erased from memory and can not be recovered. Only one macro can be purged per \*RMC" command.
2g Miscellaneous Commands
Miscellaneous Commands This sub-chapter contains detailed information on all miscellaneous programming commands.
DISPlay[:WINDow][:STATe] 2 DISPlay :WINDow 32 :STATe 3 ON OFF The \DISPlay[:WINDow][:STATe]" command turns the uorescent display and LED annunciators on and o . The parameters are as follows: ON Turns the uorescent display and LED annunciators on. OFF Turns the uorescent display and LED annunciators o .
Miscellaneous Commands DISPlay[:WINDow][:STATe] Query Syntax 2 DISPlay :WINDow 32 3 :STATe ? Returned format: state Where: state ::= \+1" if the uorescent display and LED annunciators are currently turned on. state ::= \+0" if the uorescent display and LED annunciators are currently turned o .
SYSTem:KEY SYSTem:KEY 8 9 < keycode = : MAXimum MINimum ; The \SYSTem:KEY" command simulates pressing a front panel key. The parameters are as follows: keycode The key code of the key to be pressed. The valid key code range is 0 to 62. MAXimum Sets the keycode to its maximum allowable value. MINimum Sets the keycode to its minimum allowable value. Note that the key code represents the front panel key to be pressed. There is no unique key code for shifted functions and special functions.
Miscellaneous Commands SYSTem:KEY Synthesizer Key Codes Key Name Key Code Key Name Key Code 4SHIFT5 0 455 40 4PRESET5 1 465 41 4INT 2 SPCL ON 42 4 4MHz5 42 4RECALL5 5 4 5 45 4EXT 6 4STEP LEVEL5 4MSG5 DIODE5 ) SIZE5 46 4LOCAL5 8 415 47 4SPCL5 9 425 48 4EXT 10 435 49 4 5 12 4kHz5 50 475 13 SPCL OFF 50 485 14 4RF 53 4FREQ5 23 4BACK 32 405 55 33 4.
Miscellaneous Commands SYSTem:KEY Query Syntax SYSTem:KEY? MAXimum MINimum Returned format: keycode Where: keycode ::= The last key pressed if no optional argument is speci ed. If 01 is returned, no key has been pressed since the synthesizer has been powered up or preset. NOTE This is a two key queue. It saves the rst two keys pressed. Subsequent keystrokes are not saved unless the queue is cleared or reported. PRESET or power up clears the key queue.
Miscellaneous Commands SYSTem:KEY
2h Power Level Commands
Power Level Commands This sub-chapter contains detailed information on all programming commands pertaining to power level control.
[SOURce[1]:]POWer[:LEVel] 2 2 3 3 2 SOURce 1 : POWer :LEVel 8 9 ampl > > > > > MAXimum > > > > > < = MINimum > > > UP > > > > > DOWN > > : ; DEFault 32 :IMMediate 32 :AMPLitude 3 The \[SOURce[1]:]POWer[:LEVel]" command sets the output power level of the synthesizer. The parameters are as follows: ampl Sets the synthesizer output power level.
Power Level Commands [SOURce[1]:]POWer[:LEVel] NOTE The actual maximum internally leveled output power for your instrument at a given frequency can be found by increasing the synthesizer output power until the UNLVL annunciator lights. If a power level entry is made that is not within the allowable parameter range, an error message will be generated and the parameter will be set to either its maximum or minimum limit. Power level resolution is 0.01 dB.
Power Level Commands [SOURce[1]:]POWer[:LEVel] Query Syntax 2 2 3 3 2 SOURce 1 : POWer :LEVel 3 MAXimum 4 MINimum 5 DEFault 32 2 :IMMediate 32 3 :AMPLitude ? Returned format: ampl Where: ampl ::= The current output power level if no argument is speci ed. ampl ::= The maximum output power level that can be set if the MAXimum argument is speci ed. ampl ::= The minimum output power level that can be set if the MINimum argument is speci ed.
[SOURce[1]:]POWer[:LEVel]:STEP 2 2 3 3 2 32 SOURce 1 : POWer :LEVel :IMMediate 8 9 incr > > 2 3 < MAXimum = :STEP :INCRement MINimum > > : ; DEFault 32 :AMPLitude 3 The \[SOURce[1]:]POWer[:LEVel]:STEP" command selects the increment value for the synthesizer output power level. The parameters are as follows: incr Sets the increment value for output power level. The allowable range for the parameter is 0.01 dB to 150 dB if Option 1E1 is installed and 0.01 dB to 45 dB if Option 1E1 is not installed.
Power Level Commands [SOURce[1]:]POWer[:LEVel]:STEP Query Syntax 2 2 3 3 2 32 SOURce 1 : POWer :LEVel :IMMediate 2 3 MAXimum 2 3 :STEP :INCRement ? 4 MINimum 5 DEFault 32 :AMPLitude 3 Returned format: incr Where: incr ::= The current power level increment value if no argument is speci ed. incr ::= The maximum power level increment value that can be set if the MAXimum argument is speci ed.
Power Level Commands [SOURce[1]:]POWer[:LEVel]:STEP
2i Programmable Interface Commands
Programmable Interface Commands This sub-chapter contains detailed information on all programming commands pertaining to the programmable interface.
*OPC (Operation Complete) *OPC The \*OPC" command sets bit 0 in the Standard Event Status register to one (1) when the synthesizer has completed execution of all programming commands preceding it. Query Syntax The \*OPC" command or the \*OPC?" query should appear as the last command in a command line. *OPC? Returned format: number Where: number ::= \+1" when bit 0 in the Standard Event Status register has been set to one.
Programmable Interface Commands *OPC (Operation Complete) See Also *ESE *ESR? *SRE *STB? *WAI 2i-4
SYSTem:COMMunicate:GPIB:ADDRess SYSTem:COMMunicate:GPIB:ADDRess 8 9 < address = : MAXimum MINimum ; The \SYSTem:COMMunicate:GPIB:ADDRess" command allows you to change the synthesizer HP-IB address. The parameters are as follows: address The HP-IB address of the synthesizer. The valid address range is 00 to 30 (decimal). MAXimum Sets the synthesizer HP-IB address to its maximum allowable value. MINimum Sets the synthesizer HP-IB address to its minimum allowable value.
Programmable Interface Commands SYSTem:COMMunicate:GPIB:ADDRess Query Syntax SYSTem:COMMunicate:GPIB:ADDRess? MAXimum MINimum Returned format: address Where: address ::= The current HP-IB address of the synthesizer when no optional argument is speci ed. address ::= The maximum allowable Synthesizer HP-IB address when the MAXimum argument is speci ed. address ::= The minimum allowable synthesizer HP-IB address when the MINimum argument is speci ed.
SYSTem:LANGuage SYSTem:LANGuage 8 < "SCPI" : 9 = "COMP=8673" ; "COMPATIBILITY=8673" The \SYSTem:LANGuage" command sets the programming language that is accepted by the synthesizer. The parameters are as follows: \SCPI" Sets the programming language to \SCPI" (Standard Commands for Programmable Instruments). This is the current industry standard and is the language documented in this manual. \COMP=8673" Sets the programming language to HP 8673 emulation.
Programmable Interface Commands SYSTem:LANGuage Query Syntax SYSTem:LANGuage? Returned format: lang Where: lang ::= \SCPI" if SCPI programming language is currently chosen. lang ::= \CIIL" if the CIIL programming language special order option is installed and the CIIL programming language is currently chosen.
UNIT:FREQuency 8 9 freq su x The \UNIT:FREQuency" command determines the default su x that will be assumed for the numeric argument of all frequency-related programming commands if no su x is used. It also determines the units for the data that frequency-related queries return. The parameter is as follows: freq su x The default su x to be assumed by all frequency-related programming commands when no su x is used.
Programmable Interface Commands UNIT:FREQuency Available Default Su xes Default Multiplication Su x Factor EXHZ 121018 PEHZ 121015 THZ 121012 GHZ 12109 MHZ 12106 KHZ 12103 HZ 12100 UHZ 121006 NHZ 121009 PHZ 1210012 FHZ 1210015 AHZ 1210018 NOTE 2 0 There is no su x for \1 10 3 " when working with the HZ su x.
Programmable Interface Commands UNIT:FREQuency Query Syntax UNIT:FREQuency? Returned format: freq su x Where: freq su x ::= The current default su x for frequency-related programming commands and queries.
UNIT:POWerj:VOLTage UNIT:POWer|:VOLTage 8 level su x 9 The \UNIT:POWerj:VOLTage" command determines the default su x that will be assumed for the numeric argument of all power level-related programming commands if no su x is used. It also determines the units for the data that power level-related queries return. The parameter is as follows: level su x The default su x to be assumed by all power level-related programming commands when no su x is used.
Programmable Interface Commands UNIT:POWerj:VOLTage The su xes in the above table can include an optional su x multiplier in place of \mult". For example, the volts su x \V" can be preceded by the su x multiplier \M" to yield MV (millivolts) or 121003 volts. The available su x multipliers appear in the following table.
Programmable Interface Commands UNIT:POWerj:VOLTage Query Syntax UNIT:POWer|:VOLTage? Returned format: level su x Where: level su x ::= The current default su x (including the su x multiplier) for power level-related programming commands and queries.
*WAI (Wait-to-Continue Command) *WAI The \*WAI" command makes the synthesizer wait until pending operations have taken place, then continues executing commands that follow the \*WAI" command. The \*WAI" command is useful when placed after those commands that are not necessarily nished executing before the next HP-IB command is executed when it is critical that they be nished executing.
Programmable Interface Commands *WAI (Wait-to-Continue Command)
2j RF Output Control Commands
RF Output Control Commands This sub-chapter contains detailed information on all programming commands pertaining to RF output control.
OUTPut:PROTection[:STATe] 2 OUTPut:PROTection :STATe 3 ON OFF The \OUTPut:PROTection[:STATe]" command turns RF protection during frequency switching on or o . This function is useful when measuring the synthesizer frequency switching time. The parameters are as follows: ON Turns RF protection on during frequency switching. OFF Turns RF protection o during frequency switching.
RF Output Control Commands OUTPut:PROTection[:STATe] Query Syntax 2 3 OUTPut:PROTection :STATe ? Returned format: state Where: state ::= \+1" if RF protection during frequency switching is currently turned on. state ::= \+0" if RF protection during frequency switching is currently turned o .
OUTPut[:STATe] 2 OUTPut :STATe 3 ON OFF The \OUTPut[:STATe]" command turns the signal at the RF OUTPUT connector on and o . The parameters are as follows: ON Turns the signal at the RF OUTPUT connector on. OFF Turns the signal at the RF OUTPUT connector o . When the \OUTP:STAT OFF" command is sent to the synthesizer, the internal oscillators are turned o , and the internal RF power shutdown circuit is turned on. The preset state for the signal at the RF OUTPUT connector is on.
RF Output Control Commands OUTPut[:STATe] See Also Connectors 2j-6
[SOURce[1]:]POWer:ATTenuation:AUTO 2 2 3 3 SOURce 1 : POWer:ATTenuation:AUTO 8 < ON : 9 = OFF ; ONCE The \[SOURce[1]:]POWer:ATTenuation:AUTO" command turns the attenuator hold function on or o . The parameters are as follows: ON Turns the attenuator hold function o . OFF Turns the attenuator hold function on. ONCE Turns the attenuator hold function o and then on. The attenuator hold function can be used to extend the vernier range to prevent the step attenuator from switching between two levels.
RF Output Control Commands [SOURce[1]:]POWer:ATTenuation:AUTO Disadvantages When the step attenuator is locked, the output power dynamic range is limited to the vernier range at the current output frequency. The vernier range extends from a lower limit that is typically 5 dB lower than the speci ed value for that range to an upper limit that is frequency dependent on the synthesizer output frequency.
RF Output Control Commands [SOURce[1]:]POWer:ATTenuation:AUTO See Also [SOURce[1]:]POWer[:LEVel] 2j-9
RF Output Control Commands [SOURce[1]:]POWer:ATTenuation:AUTO
2k Status Register Commands
Status Register Commands This sub-chapter contains detailed information on all programming commands pertaining to the status register.
The Status Register System You can nd out the state of certain instrument hardware and rmware events and conditions by programming the status register system. The status register system is arranged in a hierarchical order. Three lower status groups provide information to the status byte group. The status byte group is used to determine the general nature of an event and the lower status groups are used to determine the speci c nature of the event.
Status Register Commands The Status Register System Figure 2k-2. General Status Group Model Note that each status group does not necessarily contain all of the registers shown in Figure 2k-2. For example, the Standard Event status group only contains an Event Register and an Enable Register. Each of the synthesizer status groups consists of some or all of the registers explained below: Condition Register A condition register continuously monitors the hardware and rmware status of the synthesizer.
Status Register Commands The Status Register System Event Register An event register latches transition events from the condition register as speci ed by the positive and negative transition registers. Bits in the event register are latched, and once set, they remain set until cleared by either querying the register contents or sending the \*CLS" command. Enable Register An enable register speci es the bits in the event register that can generate a summary bit.
Status Register Commands The Status Register System 6 7 The Standard Event Status Group A 1 in this bit position indicates that the instrument has at least one reason to require service. The bits in the Status Byte are logically ANDed with the Service Request Enable register and the result is ORed and input to this bit. A 1 in this bit position indicates that the Standard Operation summary bit has been set.
Status Register Commands The Status Register System The Standard Operation Status Group The Standard Operation status group is used to determine the speci c condition that set bit 7 in the Status Byte. The Standard Operation status group consists of the Operation Condition register, Operation Negative Transition register, Operation Positive Transition register, Operation Event register, and Operation Event Enable register.
Status Register Commands The Status Register System 8 9 - 15 This bit is set to 1 whenever bits 3, 5, or 7 in this register are set to 1. These bits are always set to 0. Status Register System Programming Example In the following example, the Status Register System is programmed to set bit 6 of the status byte (the SRQ bit) high after the synthesizer hardware has settled. Bit 6 is monitored and, once it is set high, the controller prints \HARDWARE IS SETTLED" on its screen.
Status Register Commands The Status Register System 80: 90: 100: Set Synthesizer output frequency and power. Poll the SRQ state. If no SRQ has been generated, keep polling.
*CLS (Clear Status Command) *CLS The \*CLS" command clears the Operation Event register, Questionable Event register, and the Standard Status Event register. Sending the \*CLS" command sets all bits in the Operation Event register, Questionable Event register, and the Standard Status Event register to 0. Clearing these registers causes bits 3, 5, and 7 in the Status Byte register to be temporarily set to 0. The \*CLS" command also clears the HP-IB error reporting queue and the Request-for-OPC ag.
*ESE (Standard Event Status Enable) *ESE number The \*ESE" command sets the Standard Event Status Enable register. This register selects which bits in the Standard Event Status Register can set bit 5 in the status byte. The parameter is as follows: number The number representing the value of bits in the Standard Event Status Enable register to be set. number can be from 0 to 255. Bits in the Standard Event Status Enable register are logically ANDed with bits in the Standard Event Status register.
Status Register Commands *ESE (Standard Event Status Enable) Query Syntax *ESE? Returned format: number Where: number ::= The current value of the Standard Event Status Enable register.
*ESR? (Standard Event Status Register Query) *ESR? The \*ESR?" query returns the contents of the Standard Event Status register. When you read the contents of the Event Status register, the value returned is the total bit weights of all the bits that are high at the time you read it. The decimal value of each bit (the bit weight) in the Event Status register is shown in the following table.
Status Register Commands *ESR? (Standard Event Status Register Query) Status Reporting When an error is reported to the HP-IB error queue, one of the Standard Event Status Register error bits will also be set. Which bit is set depends on the value of the error number. If the error number is from 0199 to 0100, the Command Error bit is set. If the error number is from 0299 to 0200, the Execution Error bit is set.
*PSC (Power-On Status Clear) *PSC 0 1 The \*PSC" command enables or disables the automatic power-on clearing of the Service Request Enable (*SRE) register and the Standard Event Status Enable (*ESE) register. It also enables or disables the automatic power-on presetting of the SCPI STATus transition registers and enable registers.
Status Register Commands *PSC (Power-On Status Clear) Query Syntax *PSC? Returned format: state Where: state ::= \+0" if clearing of the *SRE and *ESE registers at power-up is disabled or \+1" if clearing of the *SRE and *ESE registers at power-up is enabled.
*SRE (Service Request Enable) *SRE number The \*SRE" command sets the Service Request Enable register bits. The parameter is as follows: number The number representing the value of bits in the Service Request Enable register to be set. The number can be from 0 to 191. The Service Request Enable register contains a mask value for the bits to be enabled to produce an SRQ in the status byte. A 1 in the Service Request Enable register will enable the corresponding bit in the status byte.
Status Register Commands *SRE (Service Request Enable) Query Syntax *SRE? Returned format: number Where: number ::= The current value of the Service Request Enable register.
STATus:OPERation:CONDition? STATus:OPERation:CONDition? The \STATus:OPERation:CONDition?" query returns the contents of the Operation Condition register. The Operation Condition register is constantly updated as operational conditions occur. No conditions are saved in this register. When you read the contents of the Operation Condition register, the value returned is the total bit weights of all the bits that are high at the time you read it.
Status Register Commands STATus:OPERation:CONDition? Operation Condition Register Bit De nitions Bit Weight Condition 15 32768 Not used - always 0. 14 16384 Not used - always 0. 13 8192 Not used - always 0. 12 4096 Not used - always 0. 11 2048 Not used - always 0. 10 1024 Not used - always 0. 9 512 Not used - always 0. 8 256 Not used - always 0. 7 128 0 = instrument is not level correcting. 6 64 Not used - always 0. 5 32 Not used - always 0. 4 16 Not used - always 0.
STATus:OPERation:ENABle STATus:OPERation:ENABle number The \STATus:OPERation:ENABle" command sets the contents of the Operation Event Enable register. The parameter is as follows: number The number representing the value of bits in the Operation Event Enable register to be set. The number must be from 0 to 32767. The Operation Event Enable register contains a mask value for the bits to be enabled to set bit 7 in the status byte.
Status Register Commands STATus:OPERation:ENABle Operation Event Enable Register Bit De nitions Bit Weight Condition 15 32768 X - don't care. 14 16384 X - don't care. 13 8192 X - don't care. 12 4096 X - don't care. 11 2048 X - don't care. 10 1024 X - don't care. 9 512 X - don't care. 8 256 X - don't care. 7 128 0 = inhibit a \level correcting" event from setting bit 7 in the status byte. 1 = enable a \level correcting" event to set bit 7 in the status byte.
Status Register Commands STATus:OPERation:ENABle See Also STATus:OPERation[:EVENt]? STATus:OPERation:CONDition? STATus:OPERation:PTRansition STATus:OPERation:NTRansition *STB? 2k-23
STATus:OPERation[:EVENt]? 2 3 STATus:OPERation :EVENt ? The \STATus:OPERation[:EVENt]?" query returns the contents of the Operation Event register. The Operation Event register holds a record of the state changes in the Operation Condition register that were de ned in the Operation Edge Registers. When you read the contents of the Operation Event register, the value returned is the total bit weights of all the bits that are high at the time you read it.
Status Register Commands STATus:OPERation[:EVENt]? Operation Event Register Bit De nitions Bit Weight Condition 15 32768 Not used - always 0. 14 16384 Not used - always 0. 13 8192 Not used - always 0. 12 4096 Not used - always 0. 11 2048 Not used - always 0. 10 1024 Not used - always 0. 9 512 Not used - always 0. 8 256 Not used - always 0. 7 128 0 = a \level correcting" event has not occurred in the Operation Condition register that is de ned by the Operation Edge registers.
Status Register Commands STATus:OPERation[:EVENt]? See Also STATus:OPERation:CONDition? STATus:OPERation:ENABle STATus:OPERation:PTRansition STATus:OPERation:NTRansition *STB? 2k-26
STATus:OPERation:NTRansition STATus:OPERation:NTRansition number The \STATus:OPERation:NTRansition" command is used to de ne which bits in the Operation Condition register will set the corresponding bit in the Operation Event register on a one to zero state change. The parameter is as follows: number The number representing the value of bits in the Operation Negative Transition register to be set. The number must be from 0 to 32767.
Status Register Commands STATus:OPERation:NTRansition Operation Negative Transition Register Bit De nitions Bit Weight 15 32768 X - don't care. 14 16384 X - don't care. 13 8192 X - don't care. 12 4096 X - don't care. 11 2048 X - don't care. 10 1024 X - don't care. 9 512 X - don't care. 8 256 X - don't care. 7 128 0 = inhibit a one to zero state change of the \level correcting" bit from setting bit 7 in the Operation Event register.
Status Register Commands STATus:OPERation:NTRansition Query Syntax STATus:OPERation:NTRansition? Returned format: number Where: number ::= The current value of the Operation Negative Transition register.
STATus:OPERation:PTRansition STATus:OPERation:PTRansition number The \STATus:OPERation:PTRansition" command is used to de ne which bits in the Operation Condition register will set the corresponding bit in the Operation Event register on a zero to one state change. The parameter is as follows: number The number representing the value of bits in the Operation Positive Transition register to be set. The number must be from 0 to 32767.
Status Register Commands STATus:OPERation:PTRansition Operation Positive Transition Register Bit De nitions Bit Weight Condition 15 32768 X - don't care. 14 16384 X - don't care. 13 8192 X - don't care. 12 4096 X - don't care. 11 2048 X - don't care. 10 1024 X - don't care. 9 512 X - don't care. 8 256 X - don't care. 7 128 0 = inhibit a zero to one state change of the \level correcting" bit from setting bit 7 in the Operation Event register.
Status Register Commands STATus:OPERation:PTRansition Query Syntax STATus:OPERation:PTRansition? Returned format: number Where: number ::= The current value of the Operation Positive Transition register.
STATus:PRESet STATus:PRESet The \STATus:PRESet" command sets the following status registers to a known state: Operation Event Enable register Operation Negative Transition register Operation Positive Transition register Questionable Event Enable register Questionable Negative Transition register Questionable Positive Transition register When the \STATus:PRESet" command is sent, the status registers are a ected as shown in the following table.
Status Register Commands STATus:PRESet See Also STATus:OPERation[:EVENt]? STATus:OPERation:CONDition? STATus:OPERation:ENABle STATus:OPERation:NTRansition STATus:OPERation:PTRansition STATus:QUEStionable[:EVENt]? STATus:QUEStionable:CONDition? STATus:QUEStionable:ENABle STATus:QUEStionable:NTRansition STATus:QUEStionable:PTRansition *STB? 2k-34
STATus:QUEStionable:CONDition? STATus:QUEStionable:CONDition? The \STATus:QUEStionable:CONDition?" query returns the contents of the Questionable Condition register. The Questionable Condition register is constantly updated as questionable conditions change. No conditions are saved in this register. When you read the contents of the Questionable Condition register, the value returned is the total bit weights of all the bits that are high at the time you read it.
Status Register Commands STATus:QUEStionable:CONDition? Questionable Condition Register Bit De nitions Bit Weight Condition 15 32768 Not used - always 0. 14 16384 Not used - always 0. 13 8192 Not used - always 0. 12 4096 Not used - always 0. 11 2048 Not used - always 0. 10 1024 Not used - always 0. 9 512 Not used - always 0. 8 256 0 = instrument is calibrated. 1 = instrument is un-calibrated. 7 128 0 = modulation circuitry is calibrated.
STATus:QUEStionable:ENABle STATus:QUEStionable:ENABle number The \STATus:QUEStionable:ENABle" command sets the contents of the Questionable Event Enable register. The parameter is as follows: number The number representing the value of bits in the Questionable Event Enable register to be set. The number must be from 0 to 32767. The Questionable Event Enable register contains a mask value for the bits to be enabled to set bit 3 in the status byte.
Status Register Commands STATus:QUEStionable:ENABle Questionable Event Enable Register Bit De nitions Bit Weight Condition 15 32768 Can't set. 14 16384 X - don't care. 13 8192 X - don't care. 12 4096 X - don't care. 11 2048 X - don't care. 10 1024 X - don't care. 9 512 X - don't care. 8 256 0 = inhibit an \instrument calibration" event from setting bit 3 in the status byte. 1 = enable an \instrument calibration" event to set bit 3 in the status byte. 7 128 X - don't care.
Status Register Commands STATus:QUEStionable:ENABle See Also STATus:QUEStionable[:EVENt]? STATus:QUEStionable:CONDition? STATus:QUEStionable:PTRansition STATus:QUEStionable:NTRansition *STB? 2k-39
STATus:QUEStionable[:EVENt]? 2 3 STATus:QUEStionable :EVENt ? The \STATus:QUEStionable[:EVENt]?" query returns the contents of the Questionable Event register. The Questionable Event register holds a record of the state changes in the Questionable Condition register that were de ned in the Questionable Edge Registers. When you read the contents of the Questionable Event register, the value returned is the total bit weights of all the bits that are high at the time you read it.
Status Register Commands STATus:QUEStionable[:EVENt]? Questionable Event Register Bit De nitions Bit Weight Condition 15 32768 Not used - always 0. 14 16384 Not used - always 0. 13 8192 Not used - always 0. 12 4096 Not used - always 0. 11 2048 Not used - always 0. 10 1024 Not used - always 0. 9 512 Not used - always 0. 8 256 0 = an \instrument calibration" event has not occurred in the Questionable Condition register that is de ned by the Questionable Edge registers.
Status Register Commands STATus:QUEStionable[:EVENt]? See Also STATus:QUEStionable:CONDition? STATus:QUEStionable:ENABle STATus:QUEStionable:PTRansition STATus:QUEStionable:NTRansition *STB? 2k-42
STATus:QUEStionable:NTRansition STATus:QUEStionable:NTRansition number The \STATus:QUEStionable:NTRansition" command is used to de ne which bits in the Questionable Condition register will set the corresponding bit in the Questionable Event register on a one to zero state change. The parameter is as follows: number The number representing the value of bits in the Questionable Negative Transition register to be set. The number must be from 0 to 32767.
Status Register Commands STATus:QUEStionable:NTRansition Questionable Negative Transition Register Bit De nitions Bit Weight 15 32768 Can't set. 14 16384 X - don't care. 13 8192 X - don't care. 12 4096 X - don't care. 11 2048 X - don't care. 10 1024 X - don't care. 9 512 X - don't care. 8 256 0 = inhibit a one to zero state change of the \instrument calibration" bit from setting bit 8 in the Questionable Event register.
Status Register Commands STATus:QUEStionable:NTRansition Query Syntax STATus:QUEStionable:NTRansition? Returned format: number Where: number ::= The current value of the Questionable Negative Transition register.
STATus:QUEStionable:PTRansition STATus:QUEStionable:PTRansition number The \STATus:QUEStionable:PTRansition" command is used to de ne which bits in the Questionable Condition register will set the corresponding bit in the Questionable Event register on a zero to one state change. The parameter is as follows: number The number representing the value of bits in the Questionable Positive Transition register to be set. The number must be from 0 to 32767.
Status Register Commands STATus:QUEStionable:PTRansition Questionable Positive Transition Register Bit De nitions Bit Weight Condition 15 32768 Can't set. 14 16384 X - don't care. 13 8192 X - don't care. 12 4096 X - don't care. 11 2048 X - don't care. 10 1024 X - don't care. 9 512 X - don't care. 8 256 0 = inhibit a zero to one state change of the \instrument calibration" bit from setting bit 8 in the Questionable Event register.
Status Register Commands STATus:QUEStionable:PTRansition Query Syntax STATus:QUEStionable:PTRansition? Returned format: number Where: number ::= The current value of the Questionable Positive Transition register.
*STB? (Read Status Byte Query) *STB? The \*STB?" query returns the current value of the synthesizer status byte. When you read the contents of the status byte, the value returned is the total bit weights of all the bits that are high at the time you read it. When you read the contents of the status byte using the \*STB?" query, the status byte is not cleared. The decimal value of each bit (the bit weight) in the status byte is shown in the following table.
Status Register Commands *STB? (Read Status Byte Query) See Also *CLS *ESE *ESR? *SRE 2k-50
3 Error Messages
Error Messages If an error condition occurs in the synthesizer, it will always be reported to both the front panel and HP-IB error queues. These two queues are viewed and managed separately. The 4MSG5 key is used to view the contents of the front panel error queue. The HP-IB query \SYSTem:ERRor?" is used to view the contents of the HP-IB error queue. If there are any error messages in the front panel error queue, the front panel MSG annunciator will be lit.
Error Messages List The list of error messages in this chapter lists all of the error messages associated with synthesizer operation. An example of the error format found in the list of error messages is as follows: 2003 0222,"Data out of range;CW FREQ(2003)" Select a CW frequency that is within range of the installed options. If other modules or options are installed that extend the CW frequency range of the signal generator, this frequency range will be extended also.
Error Messages Error Messages List Action Required 0 The text that appears below each error message listing contains corrective actions that should be followed in order to correct the error condition. Notes 1. For more information related to error messages, refer to \To Read the Contents of the Error Queue" in Chapter 2 or the \MSG" reference entry in Chapter 6 of the , and the \SYSTem:ERRor?" reference entry in Chapter 1 of this manual. 2.
Messages The following pages list all error messages in ascending manual error number order 0440 0440,"Query UNTERMINATED after inde nite response;(0440)" Correct the HP-IB controller program so that the query that returns inde nite length block data is the last item on the program line. 0430 0430,"Query DEADLOCKED;(0430)" Correct the HP-IB controller program so that no more than eight queries are executed within the same line of the program.
Error Messages Messages 0314 0314,"Save/recall memory lost;(0314)" See error 1803. 0311 0311,"Memory error;(0311)" See error 1803. 0310 0310,"System error;(0310)" Some problem occurred while parsing an HP-IB command or query. Insure that your programming is correct and try the command again. 0300 0300,"Device speci c error;(0300)" A remote command or query could not be executed because an error occurred in the synthesizer.
Error Messages Messages 0272 0272,"Macro execution error;(0272)" Indicates that a syntactically legal macro program data sequence could not be executed due to some error in the macro de nition. 0271 0271,"Macro syntax error;(0271)" Indicates that a syntax error exists in the macro de nition. 0270 0270,"Macro error;(0270)" An error occurred while attempting to de ne, query or use a macro. Check that the macros are correct using *LMC? and *GMC?.
Error Messages Messages 0223 0223,"Too much data;(0223)" Correct the HP-IB controller program so that there is less data on a single command line. The synthesizer does not have enough memory to bu er it all. 0222 0222,"Data out of range;(0222)" The parameter data was out of range. Unlike other 0222 errors, details are not known about the command or query which caused this error. 0221 0221,"Settings con ict;(0221)" The current synthesizer state does not allow the remote command or query to be executed.
Error Messages Messages 0184 0184,"Macro parameter error;(0184)" Indicates that a command inside the macro de nition had the wrong number or type of parameters. 0183 0183,"Invalid inside macro de nition;(0183)" Indicates that the program message sequence sent with *DMC or *DDT command, is syntactically invalid. 0181 0181,"Invalid outside macro de nition;(0181)" Indicates that a macro parameter placeholder was encountered outside of the macro de nition.
Error Messages Messages 0158 0158,"String data not allowed;(0158)" Correct the HP-IB controller program so that the data included with the HP-IB command does not contain string data (no single or double quote characters). 0151 0151,"Invalid string data;(0151)" Correct the HP-IB controller program so that the string data included with the HP-IB command is terminated with a single or double quote. The terminating quote must be the same as the leading quote of the string.
Error Messages Messages 0131 0131,"Invalid su x;(0131)" Correct the HP-IB controller program so that the decimal data included with the HP-IB command contains a valid su x for that command or query. 0130 0130,"Su x error;(0130)" The su x contains a syntax error. 0128 0128,"Numeric data not allowed;(0128)" Correct the HP-IB controller program so that the data included with the HP-IB command is not numeric data.
Error Messages Messages 0110 0110,"Command header error;(0110)" An error was detected in the header. 0109 0109,"Missing parameter;(0109)" This error indicates that an HP-IB command or query has too few parameters. Correct the HP-IB controller program so that the HP-IB command or query contains the correct number of parameters. 0108 0108,"Parameter not allowed;(0108)" This error indicates that an HP-IB command or query has too many parameters.
Error Messages Messages 110 110,"EEPROM unprotected;(110)" The PG switch is set to 0 which leaves the EEPROM unprotected. Open up the synthesizer and switch the PG switch to 1. This error message is only a warning. 511 511,"YTO cal data init error;(511)" The YIG oscillator factory calibration data checksum was incorrect. A new YIG calibration should be performed or else the instrument may be unable to attain lock at some frequencies.
Error Messages Messages 606 606,"Level is not in guaranteed range.;(606)" The power level requested is beyond speci cations and may be invalid. This could be due to a very low vernier setting required when attenuator hold is active. This is a \permanent" error. 608 608,"Attenuator not set before Ext Meter mode;(608)" The attenuator range must match that of the meter range desired for external meter ALC mode.
Error Messages Messages 655 655,"PG switch not set to 0;(655)" Factory frequency correction data was not saved in EEPROM because the PG switch was protecting the EEPROM from \writes". Open up the synthesizer and switch the PG switch to 0. 656 656,"Factory atness cal data veri cation;(656)" Factory frequency level calibration data was not written into EEPROM correctly. Try writing the data into the synthesizer again.
Error Messages Messages 709 709,"Hardware driver Frequency limit;(709)" The frequency entered cannot be generated by the Frequency Extension module. 710 710,"LO synthesizer went out of lock;(710)" The LO synthesizer went out of lock. This may be due to hookup or disconnection of an external time base. Enter a di erent RF frequency and then set the frequency back to the desired value to re-lock. This is a \permanent" error.
Error Messages Messages 732 732,"Same frequencies with di erent losses;(732)" The active level correction table has duplicate frequencies with di erent losses. Select a level correction table with valid data, perform an automatic level correction to get valid data into the active table, or use HP-IB to load tables with non-duplicate frequencies. This is a \permanent" error. 733 733,"Frequency table not in ascending order;(733)" The MEM:TABL:FREQ command did not contain frequencies in ascending order.
Error Messages Messages 739 739,"Invalid data in table, not recalled;(739)" This error indicates that a level correction table recall failed. Try selecting the same level correction table again. If this error message persists you will have to recreated the saved table. 740 740,"Another controller is on the HP-IB bus;(740)" An automatic level correction was attempted but failed because there is a controller on the HP-IB bus. Remove all controllers from the HP-IB bus and try again.
Error Messages Messages 745 745,"Meter returns error msg;(745)" While running the automatic level correction, the power meter returned +9.0000E+40 as the power reading. This number indicates an error within the power meter. 746 746,"Data measured is invalid or out of range;(746)" While running the automatic level correction, the power meter returned an out of range power reading or the power meter returned a non-number as its power reading.
Error Messages Messages 755 755,"Invalid data in active table, not saved;(755)" This error indicates that a level correction table save failed. Try selecting the same level correction table again. If this error message persists you will have to recreated the table. 756 756,"Factory level corr 1-20 GHz, 0 dB table;(756)" Factory frequency level correction data for 1-20 GHz band, thru path is not valid.
Error Messages Messages 764 764,"Unable to write to RAM;(764)" A write to RAM failed to verify. Run the self-test routine to check RAM for problems. 765 765,"Attempt to write to ROM;(765)" There was an attempt to write calibration data to ROM. This should not occur, but if it does, try setting the same Synthesizer function again. If this error message persists, run the instrument self-test.
Error Messages Messages 775 775,"Low band yto cal failed;(775)" The low band calibration failed and the data for the calibration was not saved. Re-try the YIG calibration and watch for the default cal points indicated when the DAC value shown for a given point says 'd t = ' instead of 'DAC = '. 776 776,"High band yto cal failed;(776)" The low band calibration failed and the data for the calibration was not saved.
Error Messages Messages 790 790,"Scan-mod 0.01-1 GHz gain tables bad;(790)" Checksum was invalid for the AM gain tables. If you need to use this frequency range and scan AM modulation, see the explanation for error number 4000. 793 793,"Scan AM cal not valid, defaults used;(793)" Scan AM level may be in error due to invalid calibration data. If you need to use scan AM modulation, see the explanation for error number 4000.
Error Messages Messages 803 803,"EEPROM not cleared, PG switch is not 0 (803)" The protection switch on the CPU board is in an incorrect position to clear EEPROM data. 900 900,"PRI increased to t pulse width;(900)" The current pulse width is too large for the current PRI. The PRI is increased to allow for the pulse width. This is a \permanent" error.
Error Messages Messages 1104 1104,"Start bit is invalid for given loop.;(1104)" See the explanation for error number 1101. 1105 1105,"Length is invalid for given loop;(1105)" See the explanation for error number 1101. 1106 1106,"Data is too large for given length;(1106)" See the explanation for error number 1101. 1107 0222,"Data out of range;Bit eld number(1107)" See the explanation for error number 1101.
Error Messages Messages 1512 0301,"8673 command K1 not emulated (1512)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken. Refer to Chapter 4, \HP 8673 Compatibility Guide" for more information. 1513 0301,"8673 command Mn not emulated (1513)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken.
Error Messages Messages 1518 0301,"8673 command 9 not emulated (1518)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken. Refer to Chapter 4, \HP 8673 Compatibility Guide" for more information. 1519 0301,"8673 command OC not emulated (1519)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken.
Error Messages Messages 1524 0301,"8673 command Tx not emulated (1524)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken. Refer to Chapter 4, \HP 8673 Compatibility Guide" for more information. 1525 0301,"8673 command TR not emulated (1525)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken.
Error Messages Messages 1530 0301,"8673 command A not emulated (1530)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken. Refer to Chapter 4, \HP 8673 Compatibility Guide" for more information. 1531 0301,"8673 command SV not emulated (1531)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken.
Error Messages Messages 1537 0301,"8673 command DF not emulated (1537)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken. Refer to Chapter 4, \HP 8673 Compatibility Guide" for more information. 1538 0301,"8673 command DW not emulated (1538)" The above command is recognized by the synthesizer in HP 8673 emulation mode, but it is not emulated. The command is thus discarded and no action is taken.
Error Messages Messages 1803 1803,"RAM data lost at power on;(1803)" All RAM data was lost. This includes all front panel settings, save/recall registers, level corrections, and other user settable values. This error message can occur when the battery voltage is low, or options change in the synthesizer. Note: Calibration data will never be lost. 1804 1804,"Self-test failure, run the self-test;(1804)" The power-on self-test detected an error or warning. See the explanation for error number 4000.
Error Messages Messages 2006 0222,"Data out of range;POWER LEVEL(2006)" Select a power level within the following ranges: No attenuator options, 015 dBm to +30 dBm. Option 1E1, -100 dBm to +30 dBm. 2012 0224,"Illegal parameter value;ALC SOURCE(2012)" The requested ALC source is not available in the synthesizer. Use *OPT? to check which options are installed. 2015 0222,"Data out of range;SPECIAL(2015)" Select a special function number that is available in the synthesizer.
Error Messages Messages 2042 0222,"Data out of range;DIAG:IBUS:DIR(2042)" Correct the HP-IB command DIAG:IBUS:DIR or DIAG:IBUS:DIR? so that its parameters are within their appropriate ranges. See the service manual for more details on this HP-IB only feature. 2045 -224,"Illegal parameter value; *EMC (2045)" This command requires a 1 or 0 as an argument. 2048 0222,"Data out of range;SYST:KEY(2048)" Select a key code available on the synthesizer's front panel.
Error Messages Messages 2078 0222,"Data out of range;OFFSET FREQ(2078)" Select an o set frequency from 5 MHz to 40 MHz. 2081 0222,"Data out of range;DIAG:FREQ:CYCL(2081)" Correct the HP-IB command DIAG:FREQ:CYCL so that its parameters are within range. See the service manual for more details on this feature. 2087 0222,"Data out of range;YIG OSC CAL FREQ(2087)" Correct the HP-IB command CAL:YIG:FREQ:STARt so that its parameter is 2 GHz or 10 GHz.
Error Messages Messages 2114 0224,"Illegal parameter value;ATTEN LOCK(2114)" The HP-IB command \POWer:ATTenuation:AUTO OFF" can only be used if the 1E1 option is installed. 2123 0222,"Data out of range;PULSE WIDTH(2123)" Select a pulse width from 0 to 419ms. 2126 0222,"Data out of range;PULSE PRI/PRF(2126)" Select a pulse repetition interval from 419 ms to a minimum depending on the current carrier frequency or select a pulse repetition frequency from 2.
Error Messages Messages 2168 0222,"Data out of range;PULSE DELAY INCR(2168)" Select a pulse delay increment from 25 ns to 838 ms. 2171 0222,"Data out of range;PULSE WIDTH INCR(2171)" Select a pulse width increment from 25 ns to 419 ms. 2174 0222,"Data out of range;PULSE PRI/PRF INCR(2174)" Select a pulse repetition interval increment from 25 ns to 419 ms or select a pulse repetition frequency increment from 1 mHz to 3.3 MHz.
Error Messages Messages 2225 0222,"Data out of range;FM SENSITIVITY(2225)" Select an FM sensitivity within its range for the current CW frequency and multiplier. 2231 0224,"Illegal parameter value;PULSE RISE TIME(2231)" The requested pulse rise time is not available in the synthesizer. Use *OPT? to check which options are installed. 2237 0222,"Data out of range;OFFSET FREQ INCR(2237)" Select an o set frequency increment from 1 kHz to 35 MHz.
Error Messages Messages 2276 0222,"Data out of range;CORR:FLAT(2276)" Correct the HP-IB command CORRection:FLATness[:DATA] so that all of its frequency parameters are from 1 GHz to 20 GHz and all of its loss parameters are from 040 dB to +40 dB. If other modules or options are installed that extend the frequency range of the synthesizer, this frequency range will be extended also.
Error Messages Messages 2309 0222,"Data out of range;CAL:AM:FREQ:START(2309)" Correct the HP-IB command CAL:AM:FREQuency:STARt so that its parameter is from 10 MHz to 40 GHz. See the service manual for more details on this feature. 2444 0222,"Data out of range;LEVEL CORR START FREQ(2444)" Select an automatic level correction start frequency from 1 GHz to 20 GHz. If other modules or options are installed that extend the CW frequency range of the synthesizer, this frequency range will be extended also.
Error Messages Messages 2471 0222,"Data out of range;HPIB ADDRESS INCR(2471)" Select an HP-IB address increment from 1 to 29. 2474 0222,"Data out of range;YIG OSC CAL FREQ INC(2474)" Correct the HP-IB command CAL:YIG:FREQuency:STARt:STEP so that its parameter is from 1 GHz to 10 GHz. 2477 0222,"Data out of range;CAL:PULSe:PINCh(2477)" Correct the HP-IB command CAL:PULSe:PINCh[:DATA] so that all of its parameters are from 0 to 255.
Error Messages Messages 2570 0224,"Illegal parameter value;POWERMETER TYPE(2570)" The selected power type is not supported by the synthesizer. 2576 0224,"Illegal parameter value;PULSE STOP SOUR(2576)" The requested pulse trigger stop source is not available in the synthesizer. Use *OPT? to check which options are installed. 2579 0224,"Illegal parameter value;TRIG:STOP:SLOP(2579)" The requested pulse trigger stop slope is not available in the synthesizer.
Error Messages Messages 2612 0224,"Illegal parameter value;FM SOURCE(2612)" The allowable arguments are EXTernal, FEED, or INTernal. FEED and INTernal are only allowed when Option 1E2 (internal modulation) is installed. 2615 0222,"Data out of range;INT FM FREQ(2615)" Select an internal FM frequency ( rate ) from 0.5 Hz to 1 MHz. 2618 0222,"Data out of range;INT FM FREQ INC(2618)" Select an internal FM frequency ( rate ) increment from 0.5Hz to 999.9995kHz.
Error Messages Messages 2642 0224,"Illegal parameter value;AM SOURCE(2642)" The allowable arguments are EXTernal, FEED, or INTernal. FEED and INTernal are only allowed when Option 1E2 (internal modulation) is installed. 2645 0222,"Data out of range;INT AM FREQ(2645)" Select an internal AM frequency (rate) from 0.5 Hz to 20 kHz. 2648 0222,"Data out of range;INT AM FREQ INC(2648)" Select an internal AM frequency (rate) increment from 0.5 Hz to 20 kHz.
Error Messages Messages 2678 0222,"Data out of range;CAL:MODS:FM(2678)" Correct the HP-IB command CAL:MODS:FM[:DATA] so that all of its parameters are from 0 to 255. 2702 0222,"Data out of range;ADD OPTION(2702)" Select an option bit number within range. See the service manual for more details on this feature. 2705 0222,"Data out of range;DELETE OPTION(2705)" Select an option bit number within range. See the Service Manual for more details on this feature.
Error Messages Messages 4005 0330,"Self-test failed;(4005)" See the explanation for error number 4000. 4006 0330,"Self-test failed;(4006)" See the explanation for error number 4000. 4007 0330,"Self-test failed;(4007)" See the explanation for error number 4000. 4008 0330,"Self-test failed;(4008)" See the explanation for error number 4000. 4009 0330,"Self-test failed;(4009)" See the explanation for error number 4000. 4010 0330,"Self-test failed;(4010)" See the explanation for error number 4000.
Error Messages Messages 4018 0330,"Self-test failed;(4018)" See the explanation for error number 4000. 4019 0330,"Self-test failed;(4019)" See the explanation for error number 4000. 4020 0330,"Self-test failed;(4020)" See the explanation for error number 4000. 4021 0330,"Self-test failed;(4021)" See the explanation for error number 4000. 4022 0330,"Self-test failed;(4022)" See the explanation for error number 4000.
Error Messages Messages 4031 0330,"Self-test failed;(4031)" See the explanation for error number 4000. 4032 0330,"Self-test failed;(4032)" See the explanation for error number 4000. 4033 0330,"Self-test failed;(4033)" See the explanation for error number 4000. 4034 0330,"Self-test failed;(4034)" See the explanation for error number 4000. 4035 0330,"Self-test failed;(4035)" See the explanation for error number 4000. 4036 0330,"Self-test failed;(4036)" See the explanation for error number 4000.
Error Messages Messages 4044 0330,"Self-test failed;(4044)" See the explanation for error number 4000. 4045 0330,"Self-test failed;(4045)" See the explanation for error number 4000. 9000 0330,"Self-test failed;(9000)" See the explanation for error number 4000.
4 HP 8673 Compatibility Guide
HP 8673 Compatibility Guide This chapter contains information pertaining to the HP 8673 compatibility with SCPI commands. In addition, information about special considerations and status bits is provided in this chapter.
Command Mapping to SCPI In Table 4-1, each HP 8673 command is listed along with its associated parameter and equivalent SCPI command (if one exists). Numbers referring to speci c notes are also listed in the table. The corresponding notes follow the table.
HP 8673 Compatibility Guide Command Mapping to SCPI Table 4-1.
HP 8673 Compatibility Guide Command Mapping to SCPI Table 4-1. HP 8673 Command Mapping to SCPI Commands (continued) HP 8673 Command Parameter Equivalent SCPI Command See Note D2 FM DEVIATION .03 MHz FM:SOUR EXT; SENS 30KHZ/V; STAT ON 2 D3 FM DEVIATION .1 MHz FM:SOUR EXT; SENS 100KHZ/V; STAT ON 2 D4 FM DEVIATION .
HP 8673 Compatibility Guide Command Mapping to SCPI Table 4-1.
HP 8673 Compatibility Guide Command Mapping to SCPI Table 4-1.
HP 8673 Compatibility Guide Command Mapping to SCPI Table 4-1.
HP 8673 Compatibility Guide Command Mapping to SCPI Table 4-1.
HP 8673 Compatibility Guide Command Mapping to SCPI Notes: Note 1 Note 2 Note 3 Note 4 Note 5 Note 6 Note 7 4-10 The command is accepted, but front panel and remote error messages are given specifying that this command is not emulated. For CW frequencies above 1 GHz, available sensitivities are as shown. When the CW frequency is below 1 GHz, sensitivity is reduced by factors of four at logarithmic intervals (see the command FM:DEV in an earlier SCPI section).
HP 8673 Compatibility Guide Command Mapping to SCPI Note 8 The RCBS command is mapped to an instrument preset (IP), except with the addition of setting the frequency to 14 GHz. The frequency multiply and ALC modes are not preserved. Note 9 This command has the same functionality as the SCPI feature *SRE; however, set and query forms are a single byte of binary data as in the HP 8673B. Note 10 The RA (Range) and \VE" (Venier) commands emulate, in most cases, the personality of the 8673.
HP 8673 Compatibility Guide Command Mapping to SCPI Note 13 Supplemental commands to 8673 that allow some key needed functionality. Note 14 The HP 83711A/12A and HP 83711B/12B synthesizers do not support modulation.
HP 8673 Compatibility Guide Command Mapping to SCPI Rounding The HP synthesizers generally round numbers according to IEEE rules; the HP 8673 rounds numbers down to a more negative value. Power Su xes Power su xes dB or dBm are generally accepted for all power level commands. Output Active Parameter The active parameter is not coordinated with the front panel. System ALC Mode The C4 (system ALC mode) is mapped to the ALC:SOUR PMETer command.
HP 8673 Compatibility Guide Command Mapping to SCPI Query Return Format The query return format, from a synthesizer product in HP 8673 emulation mode, can have signi cant di erences. In particular, the synthesizer products will ALWAYS follow every query return string with a \line feed" (i.e., 0x0A). This can cause problems, especially when RMB code has been speci cally tuned to the two byte binary format return of the HP 8673 \OS" command.
HP 8673 Status Bits This section describes the HP 8673 status and extended bytes.
HP 8673 Compatibility Guide HP 8673 Status Bits Images Table 4-2.
HP 8673 Compatibility Guide HP 8673 Status Bits Event Register Bits The status byte is an event register. Bits are set when the event occurs, and cleared only when read with the OS command. Condition Register Bits The extended status byte is a condition register. Bits are set and cleared with the condition.
HP 8673 Compatibility Guide HP 8673 Status Bits Change in ESB Bit The change in ESB bit for the HP 837XXX synthesizers will only be turned on when any bit of the extended byte becomes true; not when any bit becomes false as in the HP 8673. Front Panel Entry Complete Bit The HP 8673 front panel entry complete bit, in remote programming mode, applies only to changes in frequency increment, o set, multiply, and in some command argument out of limit conditions.
5 Legal and Regulatory Information
Legal and Regulatory Information This chapter contains information pertaining to SCPI conformance and the warranty.
SCPI Conformance The synthesizer uses the SCPI (Standard Commands for Programmable Instruments) language for HP-IB communication. The SCPI commands and queries that the synthesizer understands are listed and described individually in Chapter 2, \Programming Commands". Table 5-1 lists all of the commands and queries that the synthesizer understands and whether they are SCPI approved, SCPI con rmed, or non-SCPI. The commands and queries that are labeled \IEEE 488.2 Required" and \IEEE 488.
Legal and Regulatory Information SCPI Conformance Table 5-1. SCPI Conformance Programming Command Status *CLS IEEE 488.2 Required DISPlay[:WINDow][:STATe](?) SCPI Con rmed *DMC IEEE 488.2 Optional *EMC(?) IEEE 488.2 Optional *ESE(?) IEEE 488.2 Required *ESR? IEEE 488.2 Required *GMC? IEEE 488.2 Optional *IDN? IEEE 488.2 Required *LMC? IEEE 488.2 Optional *LRN? IEEE 488.
Legal and Regulatory Information SCPI Conformance Table 5-1. SCPI Conformance (continued) Programming Command Status *PSC(?) IEEE 488.2 Optional *RCL IEEE 488.2 Optional *RMC IEEE 488.2 Optional *RST IEEE 488.2 Required *SAV IEEE 488.
Legal and Regulatory Information SCPI Conformance Table 5-1. SCPI Conformance (continued) Programming Command Status STATus:OPERation:NTRansition(?) SCPI Con rmed STATus:OPERation:PTRansition(?) SCPI Con rmed STATus:PRESet SCPI Con rmed STATus:QUEStionable:CONDition? SCPI Con rmed STATus:QUEStionable:ENABle(?) SCPI Con rmed STATus:QUEStionable[:EVENt]? SCPI Con rmed STATus:QUEStionable:NTRansition(?) SCPI Con rmed STATus:QUEStionable:PTRansition(?) SCPI Con rmed *STB? IEEE 488.
Certi cation Hewlett-Packard Company certi es that this product met its published speci cations at the time of shipment from the factory. Hewlett-Packard further certi es that its calibration measurements are traceable to the United States National Institute of Standards and Technology, (NIST), to the extent allowed by the Institute's calibration facility, and to the calibration facilities of other International Standards Organization members.
Warranty This Hewlett-Packard instrument product is warranted against defects in material and workmanship for a period of one year from date of shipment. During the warranty period, Hewlett-Packard Company will, at its option, either repair or replace products which prove to be defective. For warranty service or repair, this product must be returned to a service facility designated by HP. Buyer shall prepay shipping charges to HP and HP shall pay shipping charges to return the product to Buyer.
Legal and Regulatory Information Warranty Exclusive Remedies THE REMEDIES PROVIDED HEREIN ARE BUYER'S SOLE AND EXCLUSIVE REMEDIES. HP SHALL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER BASED ON CONTRACT, TORT, OR ANY OTHER LEGAL THEORY.
Assistance Product maintenance agreements and other customer assistance agreements are available for Hewlett-Packard products. For any assistance, contact your nearest Hewlett-Packard Sales and Service O ce. Addresses are provided in Table 5-2.
Legal and Regulatory Information
Index
Index A B C abort statement, 1-8 address HP-IB, 2i-5 ALC source, 2a-7 ALC unleveled bits, 8673, 4-17 AM. See log AM angle brackets, 1-18 attenuator hold function, 2j-7 advantages, 2j-7 disadvantages, 2j-8 bits ALC unleveled, 4-17 change in ESB, 4-18 condition register, 4-17 event register, 4-17 F.P.
syntax overview, 1-32, 1-33 command statements, fundamentals, 1-7 command trees de ned, 1-23 how to change paths, 1-23 how to read, 1-23 using e ciently, 1-25 commas proper use of, 1-24, 1-34 common commands, 1-21, 1-24 de ned, 1-21 compatibility, 8673 to SCPI, 4-3 condition register bits, 8673, 4-17 controller de ned, 1-17 controller, de nition of, 1-6 CORRection:CSET[:SELect], 2e-13 CORRection:CSET:STATe, 2e-19 CORRection:FLATness[:DATA], 2e-15 CORRection:FLATness:POINts, 2e-17 CORRection[:STATe], 2e-21 c
E F *EMC, 2f-4 ^END, 1-18 ^END[end], 1-31 enter statement, 1-14 EOI, 1-18, 1-31 EOI, suppression of, 1-14 error message action required, 3-3 detailed description, 3-3 hardware failures, 3-4 manual error number, 3-3 SCPI error message, 3-3 SCPI error number, 3-3 error message format, 3-3 error messages list, 3-5{48 error queue front panel, 2c-7 HP-IB, 2c-7 errors permanent, 3-2 *ESE, 2k-11 *ESR?, 2k-13 event commands, 1-26 event register bits, 8673, 4-17 events event commands, 1-26 example program HP-IB ch
FREQuency:MULTiplier, 2b-7 FREQuency:MULTiplier:STEP, 2b-10 frequency multiplier value, 2b-7 functional veri cation. See self test G H I K *GMC?, 2f-6 GP-IB check, example program, 1-42 HP-IB technical standard, 1-52 HP-IB address, 2i-5 HP-IB check, example program, 1-42 HP-IB connecting cables, 1-3 HP-IB, de nition of, 1-2 *IDN?, 2c-3 IEEE mailing address, 1-52 IEEE 488.1 how to get a copy, 1-52 IEEE 488.
L M N level correction. See level correct level correction, example program, 1-45 listener, de nition of, 1-6 *LMC?, 2f-7 local lockout, example program, 1-43 local lockout statement, 1-10 local statement, 1-10 logarithmic AM.
O P *OPC, 2i-3 Operation Condition register, 2k-19 Operation Condition register bit de nitions, 2k-19 Operation Event Enable register, 2k-21 Operation Event Enable register bit de nitions, 2k-21 Operation Event register, 2k-24 Operation Event register bit de nitions, 2k-24 Operation Negative Transition register, 2k-27 Operation Negative Transition register bit de nitions, 2k-27 Operation Positive Transition register, 2k-30 Operation Positive Transition register bit de nitions, 2k-30 OPT?, 2c-4 optional pa
save/recall, 1-50 program examples, 1-41{51 program message examples, 1-27 program messages de ned, 1-17 program message terminators a ect on current path, 1-24 de ned, 1-31 syntax diagram, 1-31 use in examples, 1-19 programming commands syntax conventions, 2-2 *PSC, 2k-15 Q R queries de ned, 1-17 discussed, 1-21 query commands, 1-26 query only, 1-26 query only, 1-26 Questionable Condition register, 2k-35 Questionable Condition register bit de nitions, 2k-35 Questionable Event Enable register, 2k-37 Ques
rmware, 2c-3 RF protection circuit, 2j-3 *RMC, 2f-10 root de ned, 1-23 root commands de ned, 1-23 ROSCillator:SOURce?, 2c-6 rounding, 1-36 *RST, 2d-7 S *SAV, 2d-8 save instrument state, 2d-8 save/recall, example program, 1-50 SCPI compatibility, 8673, 4-3 SCPI conformance information, 5-3 SCPI conformance table, 5-3{6 SCPI version number, 2c-9 semicolon examples using, 1-25 problems with input statements, 1-19 proper use of, 1-24, 1-25 serial number, 2c-3 Service Request Enable register, 2k-17 Service Req
Standard Event Status Enable register, 2k-11 Standard Event Status Enable register bit de nitions, 2k-11 Standard Event Status register, 2k-13 Standard Event Status register bit de nitions, 2k-13 standard notation, 1-18 status bits, 8673, 4-16 status byte, 2k-49 Status Byte bit de nitions, 2k-49 STATus:OPERation:CONDition, 2k-19 STATus:OPERation:ENABle, 2k-21 STATus:OPERation[:EVENt]?, 2k-24 STATus:OPERation:NTRansition, 2k-27 STATus:OPERation:PTRansition, 2k-30 STATus:PRESet, 2k-33 STATus:QUEStionable:COND
T U V W tab proper use of, 1-24 talker, de nition of, 1-6 terminators program message, 1-19, 1-31 program message:use in examples, 1-19 response message, 1-19 timebase reference, 2c-6 *TST?, 2c-10 UNIT:FREQuency, 2i-9 UNIT:POWerj:VOLTage, 2i-12 version number SCPI, 2c-9 *WAI, 2i-15 whitespace proper use of, 1-24 Index-11
