Agilent Technologies A.18.00 Important Notes for Program Development

357

Chapter 7, IBASIC Controller

Important Notes for Program Development

Important Notes for Program Development

The Test Set is designed to operate the same way under automatic control as it

does under manual control. This has several implications when designing and

writing programs for the Test Set:

• To automate a particular task, determine how to do the task manually and then duplicate

the steps in the program.

• In Manual Control mode, a Test Set function must be displayed and “active” to make a

measurement or receive DUT data. Therefore, to make a measurement using an

IBASIC program, follow these basic steps:

1. Use the DISPlay command to select the screen for the instrument whose front panel

contains the desired measurement result or data field (such as AF ANALYZER).

2. Set the measurement field (such as SINAD) to the ON state.

3. Trigger a reading.

4. Read the result.

NOTE: The following sections discuss developing IBASIC p r ograms which do not use the TESTS

Subsystem. Programs written for the TESTS Subsystem require the creation of supporting

Library, Procedure, and Code files, and must be written using a specific program structu re.

The Agilent 11807A Radio Test Software packages are examples of this type of program.

Refer to the “Writing Programs For the TESTS Subsystem” on page 420 for

information on writing programs for the TESTS Subsystem.

Contents

Main 1 Agilent Technologies 8920A RF Communications Test Set ! Programmers Guide Firmware Version A.18.00 and above Agilent Part No. 08920-90220 Printed in U. S. A. April 2000 Rev. B SCREEN CONTROL INSTRUMENT STATE Notice Edition/Print Date Safety Summary Page Product Markings CERTIFICATION Page ASSISTANCE DECLARATION OF CONFORMITY Manufacturers Address: Page Service and Support Manufacturers Declaration Herstellerbescheinigung In this Book Page Page Page Page Page Page Page Page Page Page Page Page Page Page Overview of the Test Set Manual Control Mode Internal Automatic Control Mode Page External Automatic Control Mode Writing programs for the Test Set S:\agilent\8920\8920b\PRGGUIDE\BOOK\CHAPTERS\usehpib.fb Chapter 1, Using GPIB Overview of the Test Set Figure 1 Manual Control Mode CRT 33 Chapter 1, Using GPIB Overview of the Test Set Figure 2 Internal Automatic Control Mode CRT Getting Started What is GPIB? GPIB Information Provided in This Manual General GPIB Programming Guidelines Page Page Page Page Page Control Annunciators The letters and symbols at the top right corner of the display indicate these conditions: Preparing the Test Set For GPIB Use Using the GPIB with the Test Sets built-in IBASIC Controller Basic Programming Examples Page Remote Operation Remote Capabilities Addressing IEEE 488.1 Remote Interface Message Capabilities Page Page Remote/Local Modes Remote Mode Local Mode Remote or Local Mode Local To Remote Transitions Remote To Local Transitions Local Lockout Clear Lockout/Set Local Page Page Background Page HP BASIC ON TIMEOUT Example Program BASIC 61 Chapter 2, Methods For Reading Measurement Results HP BASIC ON TIMEOUT Example Program Comments for Recommended Routine Page HP BASIC MAV Example Program 65 Chapter 2, Methods For Reading Measurement Results HP BASIC MAV Example Program Comments for Recommended Routine Page Page Page Sequential and Overlapped Commands Guidelines for Operation Command Names Command Punctuation Page Page Specifying Units-of-Measure for Settings and Measurement Results Page Page Page Page Page Page Page Page Page 85 Chapter 3, GPIB Command Guidelines Guidelines for Operation Display Units and GPIB Units are not affected when changing Attribute Units. If a reference of 25% is set, 25 PCT would be printed. Using the STATe Command Page 89 Chapter 3, GPIB Command Guidelines Guidelines for Operation Sample GPIB Program Page Page GPIB Syntax Diagrams GPIB Command Syntax Diagram Listing Page Diagram Conventions ? 95 Adjacent Channel Power (ACP) Adjacent Channel Power (ACP) Page AF Analyzer Page Page AF Generator 1 AF Generator 2 Pre-Modulation Filters AF Generator 2/Encoder 103 :AMPS or :TACS 1 AM, FM, and LEVel correspond to the setting of the AFGen2 To field. 1 AM, FM, and LEVel correspond to the setting of the AFGen2 To field. 105 :NAMPs or :NTACs Page 107 :CDCSs and :DTMF :DPAGing Page :FGENerator and :TSEQuential 111 :NMT Page 113 :LTR :EDACs 115 :MPT1327 1 Integer value from 1 to 32 2 String maximum length 300 117 Configure, I/O Configure Page Page Page Page Call Processing Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Decoder :NAMPs or :NTACs and :EDACs 143 :AMPs or :TACs and :CDCSs, :DTMF, :FGEN, and :DPAG :TSEQuential, :MPT1327, and :LTR 145 Display Display Display Measure Page Page Page Page Page Page Oscilloscope For Oscilloscope measurements see the MEASure command diagram. Page Page Page Page 159 Program Program Save/Recall Registers 161 RF Analyzer RF Analyzer For RF Analyzer measurements see the MEASure command diagram. RF Analyzer 163 RF Generator RF Generator For RF Generator measurements see the MEASure command diagram. Amplitude field to off to prevent internal cross-coupling into the power de tector while zeroing. Radio Interface Radio Interface 165 Spectrum Analyzer Spectrum Analyzer For Spectrum Analyzer measurements see the MEASure command diagram. Spectrum Analyzer GPIB Only Commands Status Status Page Tests Page This command sets the number and the order of tests (steps): 173 Trigg er Trigger Integer Number Setting Syntax 175 Real Number Setting Syntax Real Number Setting Syntax Multiple Real Number Setting Syntax Multiple Real Number Setting Syntax 177 Number Measurement Syntax Number Measurement Syntax Number Measurement Syntax 179 Multiple Number Measurement Syntax Multiple Number Measurement Syntax Equivalent Front-Panel Key Commands SHIFT key, CANCEL key, CURSOR CONTROL knob DATA Keys DATA FUNCTIONS Keys Page Page Page Page Page Page Page This sets the increment value for the RF Gen Freq field to 2.5 MHz. increment value. This queries the increment value for the RF Gen Freq field. increment mode to linear or logarithmic. This queries the increment mode of the RF Generators frequency. This sets the increment mode for the RF Generators frequency to logarithmic. query the increment mode. This sets the increment values Display Units to kHz for the RF Generators frequency. This queries the increment values Display Units for the RF Generators frequency. Page This increases the RF Generators frequency by one increment value. This turns the analog bar-graph meter ON for the TX Power measurement. This queries the state of the analog bar-graph meter for the TX Power measurement. :MEter:LEND commands to set the analog bar-graph meters high endpoint and low endpoint. :MEter:LEND? commands to query the analog bar-graph meter high endpoint and low endpoint. Page This turns the measurement reference point for the TX Power measurement ON. This queries the state of the measurement reference point for the TX Power measurement. This sets the measurement reference point for the TX Power measurement to 20 watts. This queries the measurement reference point for the TX Power measurement. This sets the measurement reference points Display Units for the TX Power measurement to dBm. This queries the measurement reference points Display Units for the TX Power measurement. INSTRUMENT STATE Keys This sets the Test Sets GPIB address to 15. This queries the Test Sets GPIB address. This resets all of the active measurements in the Test Set. This resets the Test Set to its power-up state. This recalls the instrument state saved in the file SETUP1. This saves the instrument state to a file named SETUP1: This clears the instrument state SETUP2 from the selected SAVE/ RECALL mass storage device. This clears all saved instrument states from the internal SAVE/ RECALL mass storage device. SCREEN CONTROL Keys and To Screen Field This displays the Audio Frequency Analyzer screen. This queries the currently displayed screen. USER Keys Page Page IEEE 488.2 Common Commands Common Command Descriptions *IDN? (Identification Query) *OPT? (Option Identification Query) *RST (Reset) *TST? (Self-Test Query) *OPC (Operation Complete) Page Page *OPC? (Operation Complete Query) Page Page *WAI (Wait To Complete) queries until all commands or queries preceding the *WAI command have completed. Page Page *RCL (Recall Instrument State) *SAV (Save Instrument State) Page Triggering Measurements Trigger Event Trigger Modes The Trigger Mode is defined by two parameters: retriggering and settling. Page Default Trigger Mode Local/Remote Triggering Changes Trigger Commands or Page Trigger Mode and Measurement Speed Measurement Pacing Arming Hardware-Triggered Measurements Page Page Increasing Measurement Throughput Optimizing Measurement Speed Page Optimizing Measurement Setup Time Optimizing the Execution Speed of the Control Program Page Status Reporting Status Reporting Structure Overview HP 8920 Status Reportin g Structure Status Byte Register meaning. Page Page Status Register Structure Overview Page Page Page In general the status reporting structure described on the previous pag es is us ed a s follows: Queue 251 Status Register Group Contents Logical OR Figure 7 shows the Status Register Groups in the Test Set. The contents of each Status Register Group is explained in the following sections. Figure 7 Test Set Status Register Groups Operation Status Register Group Overview on page 245 for a discussion of status register operation. Figure 8 shows the structure and STATus commands for the Operation Status Register Group. Figure 8 Operation Status Register Group Logical OR Page Page Page Standard Event Status Register Group Page Page Page Page Page Output Queue Group Output Queue Page Error Message Queue Group Error Message Queue Page Questionable Data/Signal Register Group 267 Figure 12 Questionable Data/Signal Register Group Logical OR Page Page Page Call Processing Status Register Group bit assignments. Logical OR Page Page Page Calibration Status Register Group Figure 14 Calibration Status Register Group Logical OR Tabl e 22 details the Calibration Status Register Groups Condition Register bit assignments. Page Page Hardware Status Register #2 Group Figure 15 Hardware Status Register #2 Group Logical OR assignments. Too Wide Page Page Hardware Status Register #1 Group Figure 16 Hardware Status Register #1 Group Logical OR assignments. Page Page Page 289 Communicate Status Register Group 239 for a discussion of status register operation. Figure 17 shows the structure and STATus commands for the Communicate Status Register Group. Figure 17 Communicate Status Register Group Logical OR assignments. Page Page GPIB Service Requests Setting Up and Enabling SRQ Interrupts Service Request Enable Register Page Page Procedure for Generating a Service Request Example Program to Set Up and Service an SRQ Interrupt Page Page Page Instrument Initialization Methods of Initialization Power-On Reset Page Front-panel PRESET Key Page *RST IEEE 488.2 Common Command Page Page Device Clear (DCL) GPIB Bus Command Selected Device Clear (SDC) GPIB Bus Command Interface Clear (IFC) GPIB Bus Command Passing Control Configuring the Test Set as the System Controller When Active Controller Capability is Required Passing Control to the Test Set Passing Control Back to Another Controller Requesting Control using IBASIC Pass Control Examples Page 319 The following program would run in the External Controller: Page 321 The following IBASIC program would be loaded off the Memory Card and run in the Test Set: Page 6 Memory Cards/Mass Storage Default File System Default File System Mass Storage Device Overview INTERNAL DATA BUS Page Page Page Page Default Mass Storage Locations Built-in IBASIC Controller Save/Recall Registers External Disk Drive TESTS Subsystem Selecting the Mass Storage Location Mass Storage Access DOS and LIF File System Considerations File Naming Conventions Test Set File Naming Conventions Test Set File Entry Field Width Potential File Name Conflicts File Naming Recommendations Initializing Media for DOS or LIF File System Test Set File Types Storing Code Files TESTS Subsystem DOS File Restrictions Using the ROM Disk Using Memory Cards Page Setting the Write-Protect Switch The Memory Card Battery Memory Card Mass Storage Volume Specifier Memory Card Initialization Backing Up Procedure and Library Files Using the COPY_PL ROM Program Copying Files Using IBASIC Commands Copying an Entire Volume Page Using RAM Disk Initializing RAM Disks Using External Disk Drives Initializing External Disks Page Page Introduction The IBASIC Controller Screen Page Important Notes for Program Development Program Development 359 Program Development Figure 24 Program Development Methods Method 1 Method 2 Method 3 (Not Recommended) Interfacing to the IBASIC Controller using Serial Ports Test Set Serial Port Configuration Page Page 363 Interfacing to the IBASIC Controller using Serial Ports D DUT 98642-66505 Figure 25 Available Agilent RS-232 Serial Cables and Adapters 08921-61038 B C Page Page Receive and Transmit Pacing PC Configuration Page Page Page Page Terminal Configuration 373 Choosing Your Development Method Choosing Your Development Method Figure 27 Three Possible Development Methods Method 1 Method 2 Method 3 (Not Recommended) Method 1 Method 2 Method 3 Method #1. Program Development on an External BASIC Language Computer or Configuring the Test Sets GPIB Interface On the Test Set Compatible BASIC Language Computers HP BASIC for Windows PC Configuration for Windows NT Operating System How to install: Program Development Procedure Downloading Programs to the Test Set through GPIB Method #1. Program Development on an External BASIC Language Computer Uploading Programs from the Test Set to an External BASIC Controller through GPIB Method #2. Developing Programs on the Test Set Using the IBASIC EDIT Mode Selecting the IBASIC Command Line Field To use the IBASIC EDIT Mode for program development, the Entering and Exiting the IBASIC EDIT Mode Setting Up Function Keys In Microsoft Windows Terminal Setting Up Function Keys in Agilent AdvanceLink Setting Up Function Keys in ProComm Method #3. Developing Programs Using Word Processor on a PC (Least Preferred) Configuring a Word Processor Writing Lines of IBASIC Code on a Word Processor Transferring Programs from the Word Processor to the Test Set Page 389 Method #3. Developing Programs Using Word Processor on a PC (Least Preferred) Sending ASCII Text Files Over RS-232 With Windows Terminal Sending ASCII Text Files over RS-232 with ProComm Communications Software Set up the ProComm terminal emulator software on the PC as covered in Uploading Programs from the Test Set to a PC Serial I/O from IBASIC Programs Serial Ports 9 and 10 Serial I/O from IBASIC Programs Example IBASIC Program Using Serial Port 10 Serial Port 10 Information PROGram Subsystem Introduction SCPI PROGram Subsystem Test Set PROGram Subsystem The Test Set supports the following subset of the :SELected SCPI commands. The Test Set does not support the following SCPI commands. PROGram Subsystem Commands Page Page Page Page Page Page Page an external controller, the execution state of th e IBASIC program in the Test Set. a desired state from each of the possible current states. The program execution states are defined as follows: Page Page Page Page Page Page Page Using the EXECute Command Page Page Page Page The TESTS Subsystem Writing Programs For the TESTS Subsystem TESTS Subsystem File Descriptions Page TESTS Subsystem Screens Page Page Page Description of the Call Processing Subsystems Remote User Interface Operational Overview Page Using the Call Processing Subsystems Remote User Interface Connecting a Mobile Station Refer to the Users Guide for detailed information on connecting a mobile station to the Test Set. Accessing the Call Processing Subsystem Screens Command Syntax Conditioning the Test Set for Call Processing Call Processing Subsystem HP-IB Error Messages Reading A Call Processing Subsystem HP-IB Error Messages Call Processing Status Register Group Using the Call Processing Status Register Group To Control Program Flow Page When To Query Data Messages Received From The Mobile Station Page Programming the CALL CONTROL Screen Page AF Freq Amplitude Called Number: Chan: The Chan: is divided into two fields: Cntl Channel Display Page Page Page Page Page ESN (dec): ESN (hex): FM Deviation Handoff MS Id Page Order The ORDER field is updated using the command: Page [] Page Phone Num: Pwr Lvl: The Pwr Lvl: field is divided into two fields: Register [] Register Release SAT: The SAT: field is divided into two fields: SCM: SID System Type TX Freq Error TX Power Programming the CALL DATA Screen [] Active Display Word Page Reading the CALL DATA Screen Message Fields CALL DATA Screen Message Field Descriptions Page Page Page Page Page Page Page Page Querying Multiple Fields With Single OUTPUT/ENTER Programming the CALL BIT Screen Page Page [] Active Data Spec This field is used to determine how the contents of the signaling messages are built. Handoff Order Page [] Page Register [] Register Release Reading the CALL BIT Screen Message Fields messages available on the CALL BIT screen. Page Modifying the CALL BIT Screen Message Fields CALL BIT Screen Message Field Descriptions Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Page Programming the ANALOG MEAS Screen Requirements for Using The ANALOG MEAS Screen How To Program The ANALOG MEAS Screen AF Anl In AF Freq AFGen1 Freq AFGen1 To Amplitude De-Emphasis Detector Filter 1 Filter 2 FM Deviation TX Freq Error TX Power Example Measurement Routines 515 Programming the ANALOG MEAS Screen Page Programming the CALL CONFIGURE Screen CMAX Detector TX Pwr Zero Example Programs Page SRQ Example Program Page Page Page Page Page Comments for SRQ Example Program Page Polling Example Program Page Page Page Page Page Comments for Polling Example Program Page Page Page General Information About Error Messages Positive Numbered Error Messages Negative Numbered Error Messages IBASIC Error Messages GPIB1 Error Messages Text Only Error Messages The Message Display Non-Recoverable Firmware Error Page Text Only GPIB Errors Page Numbered GPIB Error Descriptions