Agilent technologies 8712et User manual

HP Instrument BASIC User’s Handbook

Supplement

Agilent Technologies

8712ET/ES and 8714ET/ES

RF Network Analyzers

Part No. 08714-90019

Printed in USA

Print Date: June 2000

Supersedes October 1998

ii HPIBASIC Supplement

Notice

The information contained in this document is subject to change without

notice.

Agilent Technologies 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. Agilent

Technologies shall not be liable for errors contained herein or for

incidental or consequential damages in connection with the furnishing,

performance, or use of this material.

Firmware Revision

This manual documents analyzers with ﬁrmware revisions E.06.00 and

above.

Contents

Contents-iii

1. Introduction

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Overview of HP Instrument BASIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

Using HP Instrument BASIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Allocating Internal Memory for IBASIC Use. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

Typographical Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

2. Recording Programs

Keystroke Recording . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

What Is Keystroke Recording?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

IBASIC Programs and the Input Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

What's in a Recorded Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

The OUTPUT Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

The ASSIGN Statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

SCPI Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7

How Recording Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8

Operations That Do Not Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9

Front Panel Operations without Mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9

HP Instrument BASIC Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10

Operations Requiring Additional Programming. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10

Mnemonics with No Corresponding Front Panel Operation . . . . . . . . . . . . . . . . . . 2-12

Avoiding Recording Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13

Use Instrument Preset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13

Speciﬁcally Select Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13

Use GPIB Echo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14

3. Running, Pausing, and Stopping Programs

Starting Programs Automatically. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

Running and Continuing a Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

Pausing and Continuing a Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

Using LOCAL LOCKOUT 8 to Disable the Pause Key . . . . . . . . . . . . . . . . . . . . . . . 3-7

Stopping a Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8

4. Saving and Recalling Programs

Selecting a Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Saving a Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Contents-iv

Contents

AUTOST Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6

Recalling a Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7

CAT to a String Array Exception. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7

Accessing Mass Storage within Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8

5. Developing Programs

External Editors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

HP BASIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

ASCII Word Processors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4

Programming Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4

Editing Your Program Using Edit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-5

The IBASIC Editor Softkeys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-6

Recording into an Existing Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7

Editing with an External Keyboard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7

Entering Program Lines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-10

Accessing the IBASIC Command Line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-10

Editing from the Front Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-11

Removing Program Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-13

Renumbering, Copying, Moving, and Indenting Lines . . . . . . . . . . . . . . . . . . . . . . .5-15

Using IBASIC Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-16

Using UTILITIES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-19

6. Debugging Programs

Setting Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3

Examining Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-4

Examining Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-5

Examining Arrays. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-5

Displaying the Last Error Encountered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-6

7. Graphics and Display Techniques

Display Partitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-2

Using the Display Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-3

Allocating Display Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-4

De-Allocating Display Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-5

Operation with No Display Partition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-5

Displaying Text. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-7

Contents

Contents-v

Getting Text to the Screen Quickly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

Pop-Up Message Windows and Custom Annotations. . . . . . . . . . . . . . . . . . . . . . . . . 7-9

Graphics Initialization and Scaling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

Using Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

Drawing Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12

Graphics Exceptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

Labeling with Different Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-15

SCPI Graphics Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16

For More Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-18

8. Interfacing with External Devices

Communication with Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

GPIB Device Selectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

Moving Data through the GPIB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

General Structure of the GPIB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

Using the Serial and Parallel Ports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6

Using the Analyzer Ports in IBASIC Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6

General Bus Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9

REMOTE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10

LOCAL LOCKOUT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10

LOCAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11

TRIGGER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11

CLEAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12

ABORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12

GPIB Service Reqsts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13

Passing and Regaining Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-16

The IBASIC GPIB Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-17

The External Bus and the Internal Bus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-17

Service Request Indicators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-17

IBASIC as the Active Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18

Passing Active Control to the Instrument. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-19

IBASIC as a Non-Active Controller. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-20

Interfacing with an External Controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-21

Synchronizing IBASIC with an External Controller . . . . . . . . . . . . . . . . . . . . . . . . 8-22

Transferring Data between Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-24

Transferring Programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-26

Contents-vi

Contents

IBASIC Communication across the LAN. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8-28

9. Using Subprograms

User-Created Subprograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-2

Built-In High-Speed Subprograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-3

Avoiding Multiple Loads of Subprograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9-9

10. IBASIC Keyword Summary

Keywords in Alphabetic Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-3

Keywords in Category Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-15

1-1

1 Introduction

1-2 HPIBASIC Supplement

Introduction

This manual describes how to create and use HP Instrument BASIC

(IBASIC) software in the analyzer. It demonstrates how to use IBASIC's

programming, editing and debugging features. It also describes how to

save and recall programs and how certain instrument-speciﬁc IBASIC

features are implemented in the analyzer. The reader should be familiar

with the operation of the analyzer and BASIC before programming the

analyzer.

Related information can be found in the following references that were

shipped with your analyzer:

• The Programmer’s Guide, a companion to this book, provides

general-purpose programming information. The Programmer’s Guide

describes all valid instrument commands.

• The User’s Guide provides information on making measurements

with the analyzer.

• The HP Instrument BASIC User’s Handbook provides information on

HP Instrument BASIC (IBASIC) .

• The Example Programs Disk — DOS format: part number

08714-10003, is included with the analyzer. This disk provides copies

of all of the example programs in the Example Programs Guide.

• Additional information on HP BASIC programming is available in the

manual set for the BASIC revision being used. For example: BASIC

7.0 Programming Techniques and BASIC 7.0 Language Reference.

Other information that may be helpful can be found in the following

reference materials:

• The Tutorial Description of the Hewlett-Packard Interface Bus

(literature no. 5021-1927) provides information on using the GPIB.

Contact the nearest Agilent sales ofﬁce for ordering information. A list of

sales and service ofﬁces can be found in the “Speciﬁcations and

Characteristics” chapter of the User’s Guide.

HP IBASIC Supplement 1-3

Introduction

Overview of HP Instrument BASIC

HP Instrument BASIC (IBASIC) can be used for a wide range of

applications, from simple recording and playback of measurement

sequences to remote control of other instruments. IBASIC is a complete

language with over 200 keywords.

IBASIC is a complete system controller residing inside your analyzer. It

communicates with the analyzer via GPIB commands over an internal

interface bus (select code 8). It can also communicate with other

instruments, computers, and peripherals using the external GPIB

interface (select code 7) or the serial (select code 9) or parallel (select code

15) I/O ports.

NOTE The analyzer can also be controlled by an external controller. It has a

factory default external GPIB address of 16. When using IBASIC to

control other instruments, no other device should use the same

address.The external GPIB address can be changed using either the

front panel keys under the , menu, or the

SCPI mnemonic SYST:COMM:GPIB:ADDR.

SYSTEM OPTIONS

GPIB

1-4 HPIBASIC Supplement

Introduction

Using HP Instrument BASIC

You need not be proﬁcient in a programming language to successfully use

IBASIC. In keystroke recording mode, IBASIC automatically builds an

executable program by capturing measurement sequences as they are

performed. With little or no editing of these program lines, you can

immediately put your program to work to control and automate your

analyzer.

The IBASIC language is a subset of the HP BASIC language. In fact,

IBASIC programs can be run on any HP BASIC workstation with very

few changes. When an external PC keyboard (with a DIN connector) is

connected to the analyzer, the IBASIC user interface emulates the user

interface of the HP BASIC. The PC keyboard can be used for command

entry, editing and program inputs.

You can use IBASIC to do the following:

• create on screen graphics

• control other instruments and peripherals

• create interactive prompts

• simplify keystrokes with the key

• create programs by recording keystrokes

• run applications

IBASIC also works in conjunction with an external controller which can

download and run programs, query variables and respond to service

requests (SRQs).

BEGIN

Other manuals for 8712ET

This manual suits for next models

Table of contents

Other Agilent Technologies Measuring Instrument manuals

Agilent Technologies

Agilent Technologies ESA-E E4402B User manual

Agilent Technologies

Agilent Technologies ESA-E E4407B Installation and operation manual

Agilent Technologies

Agilent Technologies InfiniiVision 7000B Series Operator's manual

Agilent Technologies

Agilent Technologies TS-5410 Operating instructions

Agilent Technologies

Agilent Technologies X Series User manual

Agilent Technologies

Agilent Technologies N9342C User manual

Agilent Technologies

Agilent Technologies E4443A Quick start guide

Agilent Technologies

Agilent Technologies E4406A VSA Series Manual

Agilent Technologies

Agilent Technologies FieldFox N9912A User manual

Agilent Technologies

Agilent Technologies FieldFox N9912A User manual

Agilent Technologies

Agilent Technologies E5071C User manual

Agilent Technologies

Agilent Technologies Cary 100 User manual

Agilent Technologies

Agilent Technologies E4991A User manual

Agilent Technologies

Agilent Technologies Agilent 4396B User manual

Agilent Technologies

Agilent Technologies U1731B User manual

Agilent Technologies

Agilent Technologies 71612 User manual

Agilent Technologies

Agilent Technologies u8903a User manual

Agilent Technologies

Agilent Technologies 4263B User manual

Agilent Technologies

Agilent Technologies 55B AA User manual

Agilent Technologies

Agilent Technologies 3200P User manual

Agilent Technologies

Agilent Technologies 8753ET Configuration guide

Agilent Technologies

Agilent Technologies 89410A User manual

Agilent Technologies

Agilent Technologies ESA-E Series User manual

Agilent Technologies

Agilent Technologies Agile or Elusive Signals Using Manual

Popular Measuring Instrument manuals by other brands

Powerfix Profi

Powerfix Profi 278296 Operation and safety notes

Test Equipment Depot

Test Equipment Depot GVT-427B user manual

Fieldpiece

Fieldpiece ACH Operator's manual

FLYSURFER

FLYSURFER VIRON3 user manual

GMW

GMW TG uni 1 operating manual

Downeaster

Downeaster Wind & Weather Medallion Series instruction manual

Hanna Instruments

Hanna Instruments HI96725C instruction manual

Nokeval

Nokeval KMR260 quick guide

HOKUYO AUTOMATIC

HOKUYO AUTOMATIC UBG-05LN instruction manual

Fluke

Fluke 96000 Series Operator's manual

Test Products International

Test Products International SP565 user manual

General Sleep

General Sleep Zmachine Insight+ DT-200 Service manual

Sensa Core

Sensa Core Lacto Spark user manual

VOLTCRAFT

VOLTCRAFT UTS-1980 operating instructions

EBCHQ

EBCHQ 94915 Operation manual

Balluff

Balluff BIP LD2-T017-01-EP-S4 Series user guide

Pulsar

Pulsar IMP Lite Series instruction manual

ETCR

ETCR 6800 user manual

Agilent Technologies 8712ET User manual

Popular Measuring Instrument manuals by other brands