Page 2
Warranty This Agilent Technologies product is warranted against defects in materials and workmanship for a period one year from date of shipment. Duration and conditions of warranty for this product may be superseded when the product is integrated into (becomes a part of) other Agilent products.
Page 3
REMOVE POWER and do not use the product until safe operation can be verified by service-trained personnel. If necessary, return the product to an Agilent Technologies Sales and Service Office for service and repair to ensure that safety features are maintained.
Page 4
73/23/EEC and the EMC Directive 89/336/EEC and carries the "CE" marking accordingly. Date: 18 July 2001 Ray Corson, Product Regulations Program Manager European contact: Your local Agilent Technologies Sales and Service Office or Agilent Technologies GmbH, Department HQ-TRE, Herrenberger Straße 130, D-71034 Böblingen, Germany (FAX + 49-7031-14-3143).
Warnings and Cautions WARNING SHOCK HAZARD. Only service-trained personnel who are aware of the hazards involved should install, remove, or configure the system. Before you perform any procedures in this guide, disconnect AC power and field wiring from the mainframe. Caution Do not install modules into the mainframe with power applied.
Chapter 1 Installing the System Should I Use this Guide or Agilent VIC? In an effort to make installation of your B-size VME/VXI system as easy as possible, we have included Agilent VIC (Agilent VME/VXI Installation Consultant). Agilent VIC is a Microsoftâ Windows 3.1ä compatible program that helps you configure and install your system.
Installation Steps Step 1: Set Up Mainframe f or AC Pow er (Page 1-3) Step 2: Select Int ernal IBASIC or Ext ernal Controller (Page 1-4) Step 3: Rack Mount the Mainframe (Optional) (Page 1-5) Step 4: Det ermine Inst rument Configurat ions (Page 1-6) Step 5: Set Plug-In Module Logical Addresses (Page 1-9) Step 6:...
Step 1: Set Up Mainframe for AC Power WARNING SHOCK HAZARD. Disconnect power from the mainframe before doing any installation steps. Locate line voltage Is the volt age set correct ly? select or Yes—go t o Step 2 on the next page No—perf orm steps C through F below 115 Vac 230 Vac...
Step 2: Select Internal IBASIC or External Controller Set to “ Sys Control” if you are using the internal Set to “ Talk/Listen” if you are IBASIC controller (Option 020, 021, or 022) using an ext ernal GPIB* cont roller *GPIB is the implementation of IEEE Standard 488.1-1978.
Step 3: Rack Mount the Mainframe (Optional) Note Simplified rack mount installation steps are shown here. Refer to the instructions provided with the rack mount kits for specific details. Install rails and flange nuts At tach rack mount hardw are Secure mainframe t o rack Refer to Appendix B for front handle/rack mount kit part numbers and typical configurations.
Step 4: Determine Instrument Configurations In this step, you determine the instrument configurations that best suit your application. You will create the instruments in the next step “ Step 5: Set Plug-In Module Logical Addresses.” A module can be set up as a single module instrument or as part of a multiple module instrument. For example, many Agilent plug-in modules can be configured as part of a multiple module Scanning Multimeter or Switchbox instrument.
Page 15
Scanning Multimeter Instrument The Scanning Multimeter instrument consists of an Agilent E1326B Multimeter and one or more multiplexer modules. In this configuration, the multiplexer modules scan measurement channels and feed the signal through the analog bus to the multimeter where the measurements take place. Programming is simplified because one command controls both the measurement type and the channels to be scanned.
Page 16
Switchbox Instrument The Switchbox instrument is composed of one or more switch modules. The single module Switchbox behaves as an independent instrument as described earlier. When using the multiple module Switchbox, all switch modules are programmed together and behave as if they are one instrument. The multiple module Switchbox configuration is recommended when you need to: •...
Step 5: Set Plug-In Module Logical Addresses As shown in Figure 1-4, a logical address switch contains eight individual switches. To determine the logical address, add together the decimal values of the switches that are set (position 1 = set, 0 = not set). For example, in Figure 1-4, switches 4, 5, and 6 are set, the other switches are not set.
Page 18
Locate and Set the Logical Address Switch on all Modules: Example 1-1. Single Module Instruments: 1-10 Inst alling the Syst em...
Page 19
Example 1-2. Scanning Multimeter Instrument: Example 1-3. Built-In Scanning Multimeter: Inst alling the Syst em 1-11...
Page 20
Example 1-4. Multiple Module Switchbox Instrument: 1-12 Inst alling the Syst em...
Step 6: Install Plug-In Modules WARNING SHOCK HAZARD. Secure modules tightly to the mainframe and cover all unused slots. Caution To prevent equipment damage, DISCONNECT the mainframe’s power before installing any module into the mainframe. Install B-Size Modules: Install A-Size Modules: Note On older mainframes, you must set the interrupt bypass switches (see Appendix B).
Step 7: Connect Bus Cables (Multiple Module Instruments Only) The Analog Bus creates an analog signal path between modules. The Analog Bus cables are always used in the Scanning Multimeter instrument and can also be used to link multiplexers in a Switchbox instrument. Step 7A: Connect Analog Bus Cables Scanning Multimeter: Multimeter Module...
Page 23
The Digital Bus ensures maximum scanning rates when using a Scanning Multimeter containing FET type multiplexers (Agilent E1351A, E1352A, E1353A, E1357A or E1358A). The Digital Bus is not used with relay type multiplexers such as the Agilent E1345A. Step 7B: Connect Digital Bus Cables (FET Multiplexers Only) Scanning Multimeter: Scanning Multimeter (Internal Multimeter): Inst alling the Syst em 1-15...
Step 8: Connect Interface Cables Connect the GPIB Cable to External Controller/GPIB Peripherals: 1-16 Inst alling the Syst em...
Page 25
Connect the RS-232 Cable to a Computer or Terminal: Computer 9-Pin Female 9-Pin Female Connector Connector Agilent 24542U Cable (shipped w ith Agilent VIC) Terminal 9-Pin Female 25-Pin Male Connector Connector Agilent 24542G Cable Set your computer or terminal communications protocol to: •...
Step 9: Apply AC Power WARNING The power cord must be plugged into an approved three-contact electrical outlet. The outlet must have its own ground connector connected to an electrical ground. Press The mainframe’s power cord receptacle and power cord meet international safety standards. 1-18 Inst alling the Syst em...
Step 10: Connect External DC Power (Optional) WARNING To prevent possible electric shock hazard during DC power operation, connect the mainframe’s chassis terminal to earth ground. Inst alling the Syst em 1-19...
Step 11: Download Device Drivers If your instrument is not listed in the table below, you must download the device driver so that the mainframe can interpret the instrument’s SCPI (Standard Commands for Programmable Instruments) commands. Device drivers enable register-based modules to be programmed using SCPI commands. Factory Installed Device Drivers: Register-Based Device Device Description...
Step 12: Verify Operation This step verifies mainframe operation by: • Checking for start-up errors • Checking for system errors • Checking/Setting the System Time • Checking/Setting System Date • Determining the Installed Instruments Use Step 12A to verify using a program supplied on the “Verification and Example Program Disk”, or use Step 12B to verify using other programs.
Programs for Window s • VERF_VBS.EXE - this program requires either an Agilent 82335, 82540, or 82541 GPIB Interface Card. The program was written in Visual BASIC using the Agilent Standard Instrument Control Library (SICL), which comes with the Agilent 82540 or 82541 GPIB Interface Card. •...
Page 31
For example, “ ” shows that the Logical Address Switch may be set wrong. See CNFG ERROR: 13 Appendix A for the different error messages and possible causes. Note If “ CNFG ERROR: 3” is noted, download the driver for the module that caused this error.
The returned message for the date is a comma separated list: yyyy,mm,dd where “ yyyy” is the year, “mm” is the month, and “ dd” is the day. For example, if the returned message is “ + 1994,+ 7,+ 24” , it shows a date of 7/24/1994 or July 24,1994. To set the system date, send: SYSTem:DATE <...
Chapter 2 Sending SCPI Commands This chapter shows how to send Standard Commands for Programmable Instruments (SCPI) and IEEE 488.2 Common Commands to the Agilent E1300/E1301 Mainframe from a computer over the General Purpose Interface Bus (GPIB) , or from a Terminal. Chapter contents are: •...
Using Visual BASIC and Agilent SICL The following shows how to use the Visual BASIC program language (version 3.0) with the Agilent Standard Instrument Control Library (SICL) and the Agilent 82335, Agilent 82340, or Agilent 82341 GPIB Interface Card. Both the GPIB Card and SICL are used in a PC type computer under Microsoft® Windows...
Page 35
Open Communication Path Use the iopen subproutine to open the communication path between the instrument and Visual BASIC. The command requires the complete GPIB address. Open the I/O Session Addr = iopen(" hpib7,9,0" ) I/O Address (e.g., GPIB Address) Session Identifier I/O Interface (i.e., GPIB Card) Opens I/O Session Sending SCPI Commands...
Program Example The following program example sends a SCPI command and returns the data into a string variable. Sub Main () Dim Addr As Integer Dim Cmd As String Dim RdMsg As St ring * 256 Dim Lengt h As Integer Dim Act ual As Long ’...
Using C/C+ + and Agilent SICL The following shows how to use the Visual C/C+ + program language with the Agilent Standard Instrument Control Library (SICL) and the Agilent 82335, Agilent 82340, or Agilent 82341 GPIB Interface Card. Both the GPIB Card and SICL are used in a PC type computer under Microsoft® Windows or Windows NT. The Agilent Standard Instrument Control Library provides the functions to send the SCPI commands that control instrument operation.
From the Window s Interface Select the C/C+ + Windows environment and make sure the program to be compiled and the appropriate libraries are in a project file. Then do the following: • For Borland compilers, select: Project | Open Project to open the project, then to compile the program Compile | Build All...
Page 39
Sending SCPI Commands as Formatted Data iprintf(addr, “ % s %i\n” , cmd, parm); Variable containing the parameter Function Variable containing the SCPI command Session ID Command format plus Line Feed Sending SCPI Commands as a Block of Data iw rite(addr, “ ABORt \n” , 6, 1, NULL); NULL = No Returned Length Value Function End Indicator...
Using Single Function to Send and Receive Data ipromptf function sends formatted SCPI commands and immediately reads the returned data as formatted data. This function is a combination of the functions. iprintf iscanf Sending/Receiving Formatted Data ipromptf (addr, “ * OPC?\n” , “ %i” , &into); Variable to received returned data Function Returned data format specifier...
/* Read returned data * / iread(addr, into, length, NULL, &actual); /* NULL terminates result string and print the results * / if (actual) into[actual - 1] = (char) 0; print f(“ \n%s” , int o); /* Close communication * / iclose(addr);...
Using C and the GPIB Command Library The following shows how to use the C program language with the GPIB Command Library and the Agilent 82335 GPIB Interface Card (the command library is supplied with the GPIB Card). Both the GPIB Card and Command Library are used in a PC type computer.
Compiling a Program To compile a program from the DOS command line using the Large memory model, execute the following: • Microsoft® C/ and C+ + : cl /AL < path\program name.C> path\clhpib.lib • Borland C and C+ + : tcc -ml <...
Using BASIC/IBASIC The following shows how to use the BASIC/IBASIC program language (version 5.0 and above). BASIC/IBASIC languages are in a variety of HP computers, including many Series 200/300 computers. These computers normally have the means for GPIB connections. BASIC/IBASIC have the means to directly send commands to the instruments and to directly receive data from the instruments over GPIB.
Program Example A typical program example is as follows. This example sends a SCPI command and returns the data into a string variable. 10 DIM A$[256] 20 ! 30 ! Send SCPI command 40 OUTPUT 70900.;" SYSTem:ERRor?" 50 ! 60 ! Read dat a 70 ENTER 70900.;A$ 80 ! 90 ! Print returned data...
Using a Terminal The following shows how to use a supported terminal to send SCPI commands to an instrument and display returned data. The supported terminals are: • HP 700/92 • HP 700/94 • HP 700/22 • HP 700/43 • DEC®...
Page 48
where is the Logical Address of the instrument to be selected. For < logical address> example, “ SA 24 ” selects the Agilent E1326 Multimeter. Select Instrument from an Instrument Menu An Instrument Menu is normally indicated by the instrument title shown on the display. For example, if the system is selected, the title is typically displayed as “...
Appendix A In Case Of Difficulty This appendix gives possible failures and troubleshooting information for the mainframe. Included are start-up and system errors, and their descriptions. No Communication Between Mainframe and Computer When the mainframe is unable to communicate with the computer, do the following: 1.
Start-Up Errors and Messages The Start-up errors and descriptions are listed in Table A-1. Table A-1. Start-Up Errors Code Message Cause Failed Device VXI device f ailed its self test. Unable to combine device Device t ype cannot combine into an instrument such as a scanning voltmeter or a sw itchbox.
Error 3: Config warning. Device driver not found The mainframe generates this error when it detects a module that has no driver present. Many instruments, like the Agilent E1326 Multimeter and Agilent E1345/E1346/E1347, etc. switches, have the built-in drivers in ROM. For other modules, like the Agilent E1340 Arbitrary Function Generator, its driver must be downloaded.
Error Types The returned error message consists of a number and a message. A positive number shows instrument specific errors. Negative numbers determined different types of errors as summarized in Table A-2. The different negative numbered types are explained following the table. Table A-2.
Page 53
The numeric value specif ied is not allow ed. -240 Hardw are error Hardw are error detected during pow er-on cycle. Return mainframe to Agilent Technologies f or repair. -310 Syst em error If caused by * DMC, then macro memory is full.
Page 54
Table A-4. System Errors (cont.) Code Message Cause + 2003 Invalid w ord address An odd address w as specif ied for a 16 bit read or w rite. Alw ays use even addresses for 16 bit (w ord) accesses. + 2005 No module at logical address A non-existent logical address w as specif ied w ith the VXI:READ? or VXI:WRITE command.
Appendix B Hardware Reference Information RS-232 Cable Information The recommended RS-232 cables/adapters and their Agilent part numbers are: 9-pin female to 9-pin female cable (provided with Agilent VIC) ..Agilent 24542U 9-pin male to 25-pin female adapter (provided with Agilent VIC) ..Agilent 5181-6641 9-pin female to 25-pin male cable .
Power Cords Figure B-2 shows the Agilent E1300B/E1301B power cords.. Aust ralia Figure B-2. Agilent E1300B/E1301B Power Cords Replacement Fuses The replacement line fuses and their Agilent part numbers are: 1.5A Fuse (for 115VAC operation) ....Agilent 2110-0304 3.0A Fuse (for 230VAC operation) .
Rack Mount and Front Handle Kits Table B-1. Mainframe Front Handle/Rack Mount Kits Option Description Part Number Front Handle Kit 5062-5367 Rack Mount Flanges and Rails Kit E1300-80908 Rack Mount Flanges, Handles and Rails Kit E1300-80909 Rack Slide Kit (use instead of rails) 1494-0059 Hardw are Ref erence Information B-3...
Page 58
Front Handles (Option 907) Flush Mount-Front (Option 908) Recessed Mount-Front (Option 908) Flush Mount-Rear (Option 908) Flush Mount w it h Handles-Front (Option 909) Recessed Mount-Rear (Option 908) Figure B-3. Front Handle/Rack Mount Configurations B-4 Hardw are Reference Informat ion...
Agilent E1300B/E1301B Backdating Information Setting the Mainframe Interrupt Bypass Switches NOTE: This procedure is for older mainframes only. This step is not necessary if the serial number prefix is 3327A on your Agilent E1300B, or 3326A on your Agilent E1301B. On newer mainframes, the backplane automatically bypasses empty slots for daisy-chained signals required by the VXIbus and VMEbus specifications.
Appendix C Debugging VXI SCPI Programs Introduction This appendix shows how to debug programs for the mainframe and installed modules using the Standard Commands for Programmable Instruments (SCPI). SCPI provides a common language for the mainframe and modules to simplify programming and debugging. For specific commands, refer to the mainframe and module’s User’s manuals.
Page 62
The first code in the GPIB address is the Select Code. Most computers will most likely use a Select Code of 7. However, if IBASIC is installed, the select code used by IBASIC is 8. Typical GPIB addresses for different program languages and libraries are: •...
Determining Instrument Communication Use the * IDN? command to determine if the computer can communicate with the instrument. Send the command using the Secondary GPIB address (i.e., Logical Address / 8) of the instrument. The following IBASIC sends to command to an instrument at Logical Address 24 (Secondary GPIB address of 03):: DIM A$[128] ! Dim variable for returned data OUTPUT 80903;"...
command outputs a “ 1” after all previous commands are completed (see “ Step 8: * OPC? Check for Command Synchronization” for more information on the command). Step 3: Query the Instruments for Errors All instruments that follow the SCPI definition have an Error Queue. Each error that occurs is stored into the queue.
• command spelling • missing the space between the command and parameter • parameter out of range • setting conflict caused by coupled commands not sent as a group (see “ Step 7: Check that Coupled Commands are Sent as a Group” ) Step 5: Check the Program is Trying to Enter the Same Amount An error is caused if the program is set to receive different amount of data than the instrument is attempting to output.
1. Take One Voltmeter Reading - This example uses the Agilent E1326 Multimeter OUTPUT 80903;" CONF:VOLT:DC (@100)" ! Setup multimeter to take one reading OUTPUT 80903;" INIT;:FETCH?" ! Initiate and read data ENTER 80903;A ! Enter the reading 2. Function Generator is to Output 100 Cycles of a Waveform after an External Trigger - This example uses the Agilent E1340 Arbitrary Function Generator to output the waveforms after receiving a trigger signal on its “...
To synchronize instruments, send a command to the first instrument to output data. The computer then waits for the data to be returned before it sends the commands to the second instrument. A special IEEE 488.2 command known as was created to do this. This command outputs a “ 1” whenever the instrument * OPC? has completed executing all previous commands.
Using the Program The following shows how to use the program with your application code. Step 1: Run Program Without Application Code Run the program with no application code in Subprogram “ Main”. This verifies that you can successfully communicate with both the Agilent E1326 and the System instrument. If errors occur, calling Subprogram “...
The second error: DVM ERROR “ Query UNTERMINATED” is ignored because the process of querying for errors caused it. A “ Query UNTERMINATED ” error occurs any time a second query command (i.e., a command with a “ ?” in it) occurs before the data from the first is retrieved.
Page 70
Preventing Hang-Ups The “ Main” section of the program (lines 10-220) act as a shell that prevents your basic program from ever hanging up due to I/O that is not proceeding. It identifies the LINE NUMBER of lines that have RUN TIME ERRORS or that have TIMED OUT.
Using Softkeys The following four softkeys to aid in debugging are provided as a feature of the main line of this program. Checks for instrument errors and then stop. QUIT& ? Ends the program immediately with no error checking. END! SYS_STAT Queries the System instrument for all command parameter settings and print out information on logical addresses in the system.
Page 73
Index A-Size modules, installing, 1-13 AC power cords, B-2 Cables: AC power, setting up mainframe for, 1-3 analog bus, 1-14 Adapter, RS-232, B-1 connecting interface, 1-16 Address: connecting scanning multimeter, 1-14 logical, 1-9 custom RS-232, B-1 secondary GPIB, 1-6 - 1-8 digital bus, 1-15 setting plug-in module, 1-9 GPIB, 1-16...
Page 74
Configuring: Description, program, C-8 scanning multimeter instrument, 1-7 Determine: single module instruments, 1-6 additional information, C-2 switchbox instrument, 1-8 instrument configurations, 1-6 Connecting: logical addresses, C-2 analog bus cables, 1-14 Determining instrument communication, C-3 external DC power, 1-19 Determining system information, C-2 GPIB cable, 1-16 Device driver not found warning, 1-20 interface cables, 1-16...
Page 75
Internal scanning multimeter, 1-11 Interrupt bypass switches, setting, B-5 GPIB: addressing, 2-1 cable, connecting, 1-16 Languages, using other program, C-7 cable part numbers, B-1 Latched operation, 1-2 command library, 2-10 Line power: secondary address, 1-6 - 1-8 cords, replacement, B-2 using c, 2-10 fuses, replacement, B-2 Grounding and power warning, 1-18...
Page 76
scanning multimeter example, 1-11 Program: switchbox example, 1-12 compiling a C, 2-11 Multimeter, scanning:, 1-11 executing a C, 2-10 creating, 1-7 message terminator, C-3 Multiple module instruments, configuring, 1-7 - 1-8 RN26_RMB, C-7 Multiplexers: theory, C-9 allowed in switchbox, 1-8 Program example as part of scanning multimeter, 1-7 BASIC/IBASIC, 2-14...
Page 77
cable part numbers, B-1 configuring, 1-6 cable, connecting, 1-17 example, 1-10 custom cable, B-1 Softkeys, using, C-10 protocol settings, 1-17 Standalone instruments, configuring, 1-6 Start-Up errors, A-2 Start-Up errors and messages, A-2 Starting the application code, C-11 Static electricity caution, vii Scanning DVM or DMM Step 1: set up mainframe for AC power, 1-3 See Scanning multimeter...
Page 78
Terminal, using a, 2-15 Terminator, program message, C-3 Theory, program, C-9 TIMEOUTS, using, C-9 Trickle charge switch setting, 1-2 Types, error, A-4 Unassigned module, 1-9 Unique logical address, 1-9 Using: a terminal, 2-15 BASIC/IBASIC, 2-13 C and the GPIB command library, 2-10 C/C+ + and Agilent SICL, 2-5 other program languages, C-7 single functions to receive data C/C+ + , 2-8...