Agilent B2200A Femto Leakage Switch Mainframe Agilent B2201A 14ch Low Leakage Switch Mainframe User’s Guide Agilent Technologies
Notices © Agilent Technologies 2004, 2005 Warranty No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Agilent Technologies, Inc. as governed by United States and international copyright laws. The material contained in this document is provided “as is,” and is subject to being changed, without notice, in future editions.
DEC LARA TION OF CONFORMITY According to ISO/IEC Guide 22 and CEN/CENELEC EN 45014 Manuf acturer ’s Name : Manufact urer ’s Address : Supplier’s Address : Agilen t Technologies Interna tional sarl Rue de la Gare 29 CH - 1110 Morge s Switzerlan d Declares under sole responsibility that the product as originally delivere d Product Name : Model Number : Product Options : Femto Leakag e Switch Mainframe Femto Lea kage Switc h Modul e 14ch Low Leakag e Switc h Mainfram e 14ch Low Leakag e Switc h Modul e A
• Herstellerbescheinigung GEÄUSCHEMISSION Lpa < 70 dB am Arbeitsplatz normaler Betrieb nach DIN 45635 T. 19 • Manufacturer’s Declaration ACOUSTIC NOISE EMISSION Lpa < 70 dB operator position normal operation per ISO 7779 NOTE This ISM device complies with Canadian ICES-001. Cet appareil ISM est conforme ?Hla norme NMB-001 du Canada. This product complies with the WEEE Directive (2002/96/EC) marking requirements.
Safety Summary The following general safety precautions must be observed during all phases of operation, service, and repair of this instrument. Failure to comply with these precautions or with specific warnings elsewhere in this manual may impair the protections provided by the equipment. In addition, it violates safety standards of design, manufacture, and intended use of the instrument. Agilent Technologies, Inc. assumes no liability for customer’s failure to comply with these requirements.
• DO NOT SUBSTITUTE PARTS OR MODIFY INSTRUMENT Because of the danger of introducing additional hazards, do not install substitute parts or perform any unauthorized modification to the instrument. Return the instrument to a Agilent Technologies Sales and Service Office for services and repair to ensure that safety features are maintained. • DANGEROUS PROCEDURE WARNINGS Warnings, such as example below, precede potentially dangerous procedures throughout this manual.
Safety Symbols The general definitions of safety symbols used on equipment or in manuals are listed below. Instruction manual symbol: the product will be marked with this symbol when it is necessary for the user to refer to the instruction manual in order to protect against damage to the instrument. Indicates dangerous voltage and potential for electrical shock. Do not touch terminals that have this symbol when insrument is on.
In This Manual This manual is a user’s guide for Agilent B2200A/B2201A Switch Mainframe, and consists of the following chapters: • Introduction Describes an overview and specifications of the Agilent B2200 series. • Installation Describes how to install the Agilent B2200 and how to setup the input/output. • Front Panel Operation Explains the front panel operation and the switch control functions of the Agilent B2200, also provides the reference information of the front panel keys and display.
Contents 1. Introduction Agilent B2200 Series . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Front Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4 Rear Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Self-Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10 Output Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Output Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Connector Plates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . To Make Connections to DUT Interface . . .
Contents To Set GPIB Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 To Set Remote Display Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 To Return to Local Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Switch Control Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 Channel Configuration Mode . . . . . . . . . . . . . . .
Contents Using Couple Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14 Saving Input/Output Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16 Defining Comment for Internal Memory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18 Capacitance Compensation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Capacitance Compensation Function. . . . . . . . . . . . . . . . . . . .
Contents [:ROUTe]:AGND:CHANnel:DISable[:LIST] . . . . . . . . . . . . . . . . . . . . . . . . 5-25 [:ROUTe]:AGND:CHANnel:ENABle:CARD. . . . . . . . . . . . . . . . . . . . . . . . . 5-25 [:ROUTe]:AGND:CHANnel:ENABle[:LIST] . . . . . . . . . . . . . . . . . . . . . . . . 5-26 [:ROUTe]:AGND:PORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27 [:ROUTe]:AGND[:STATe]. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28 [:ROUTe]:AGND:UNUSED .
Contents :SYSTem:ERRor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :SYSTem:KLC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :SYSTem:MEMOry:COMMent. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :SYSTem:MEMOry:DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . :SYSTem:MEMOry:LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents agb220xa_cmdData_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13 agb220xa_cmdInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13 agb220xa_cmdInt16Arr_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14 agb220xa_cmdInt16_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14 agb220xa_cmdInt32Arr_Q. . . . . . . . . . . . . . . . . . . .
Contents agb220xa_readStatusByte_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . agb220xa_reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . agb220xa_revision_query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . agb220xa_selectCompenFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . agb220xa_self_test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1 Introduction
Introduction This chapter describes the basic functions and features of the Agilent B2200A/B2201A (Agilent B2200 series), and consists of the following sections: • “Agilent B2200 Series” • “Front Panel” • “Rear Panel” • “Switch Modules” • “Specifications” • “Accessories and Options” 1-2 Agilent B2200 User’s Guide, Edition 2
Introduction Agilent B2200 Series Agilent B2200 Series Agilent B2200 series is a switching matrix designed for semiconductor dc characteristics measurement applications. The Agilent B2200 series has 14 input ports and four card slots for the switch modules (plug-in cards), and can configure a 12, 24, 36, or 48 outputs switching matrix. The Agilent B2200A/B2201A supports the following dedicated switch module. • Agilent B2210A fA Leakage Switch Module Dedicated for the Agilent B2200A mainframe.
Introduction Front Panel Front Panel The Agilent B2200 series provides the front panel keys, the LCD, and the LED matrix display for the status monitor and connection setup. • Line switch Used to turn the Agilent B2200 on or off. • LCD Used to monitor the status and set the connection. See Chapter 3 for the details. • Front panel keys Used to set the Agilent B2200. See Chapter 3 for the details. • LED matrix display Displays the status of the matrix switches.
Introduction Front Panel Figure 1-1 Front Panel View Agilent B2200 User’s Guide, Edition 2 1-5
Introduction Rear Panel Rear Panel The Agilent B2200 series has four card slots for the switch modules, the GPIB interface and so on. • Card slots For the Agilent B2200A mainframe, the Agilent B2210A cards are installed. For the Agilent B2201A mainframe, the Agilent B2211A cards are installed. Mixed configuration of the switch modules is not supported. • GPIB interface Use an Agilent 82357A USB/GPIB interface or Agilent 10833A/B/C/D GPIB cable to connect to an external computer or equipment.
Introduction Rear Panel Figure 1-2 Rear Panel View Agilent B2200 User’s Guide, Edition 2 1-7
Introduction Switch Modules Switch Modules The Agilent B2200A and B2201A support the dedicated switch module, Agilent B2210A and B2211A, respectively. By installing the modules, the module inputs will be connected internally to the front panel input connectors. And 12 output connectors will face the rear panel. The type of the output connectors is the triaxial BNC. Up to six kelvin outputs are available.
Introduction Switch Modules Figure 1-4 Switch Module Block Diagram Output 1 2 3 4 5 6 7 8 9 10 11 12 Input 1 2 3 4 5 6 7 8 9 10 11 12 13 CMH 14 CML Agilent B2200 User’s Guide, Edition 2 1-9
Introduction Specifications Specifications This section lists specifications and supplemental information for the Agilent B2200 series. • “General Specifications” • “Switch Modules” • “Supplemental Information for B2200A/B2210A” • “Supplemental Information for B2201A/B2211A” The specifications are the performance standards or limits against which these units have been tested. The supplemental information is not warranted, but provides useful information about functions and performance.
Introduction Specifications General Specifications Temperature range: Operating: 5 °C to 35 °C Humidity range: Operating: 5 % to 70 % R.H., non-condensing Storage: − 20 °C to 70 °C Storage: < 80 % R.H. at 35 °C, < 60 % R.H. at 65 °C, non-condensing (B2200A/B2210A) < 80 % R.H. at 65 °C, non-condensing (B2201A/B2211A) Altitude: Operating: 0 to 2,000 m (6,500 ft) Storage: 0 to 15,240 m (50,000 ft) Regulatory compliance: Safety: CSA C22.2 No. 1010.
Introduction Specifications Switch Modules Table 1-1 lists the specifications when the switch module is installed in the mainframe. In the table, the conditions are as follows: Conditions: 23 °C ± 5 °C, 5 % to 60 % R.H. Table 1-1 Agilent B2210A/B2211A Switch Module Specifications B2210A B2211A SMU input 1.0 1.0 AUX input 0.5 0.
Introduction Specifications Supplemental Information for B2200A/B2210A Offset current 1 IM noise (RMS) < 10 fA (typical 3 fA) (SMU input) 2 Channel crosstalk capacitance 0.6 fA (SMU input) < 1 pF/channel (SMU input) < 3 pF/channel (AUX input) Offset voltage < 50 µV (SMU input) < 80 µV (AUX input) Settling time 3 2.0 seconds Bandwidth (at -3dB) 30 MHz (SMU input) Guard capacitance 4 < 145 pF (SMU input) 5 Additional C measurement error < ± 1 % + 0.2 pF (SMU input) 1.
Introduction Specifications Supplemental Information for B2201A/B2211A Offset current 1 IM noise (RMS) < 50 fA (SMU input) 2 Channel crosstalk capacitance 5 fA (SMU input) < 0.5 pF/channel (SMU input) < 3 pF/channel (AUX input) Offset voltage < 80 µV (SMU input) < 100 µV (AUX input) Settling time 3 2.0 seconds Bandwidth (at -3dB) 30 MHz (SMU input) Guard capacitance 4 < 145 pF (SMU input) 5 Additional C measurement error < ± 1 % + 0.2 pF (SMU input) 1.
Introduction Accessories and Options Accessories and Options Agilent B2200 is furnished with the following accessories. • Power cable, 1 ea. • Operation summary sheet, 1 ea. • Manual CD-ROM, 1 ea. • Software CD-ROM, 1 ea. Stores the Agilent B2200 VXIplug&play driver. The Agilent B2200 VXIplug&play driver supports Windows XP Professional, Windows 2000, Windows NT 4.0, Windows 98, and Windows 95.
Introduction Accessories and Options Table 1-2 Options and Accessories Model Number Option Item B2200A Description fA Leakage Switch Mainframe B2200A-UK6 Commercial cal. certificate w/ test data B2200A-ABA Manual set, English B2200A-ABJ Manual set, Japanese B2201A 14ch Low Leakage Switch Mainframe B2201A-UK6 Commercial cal.
Introduction Accessories and Options Model Number Option Item 16494A Description Triaxial cable 16494A-001 1.5 m length 16494A-002 3 m length 16494A-003 80 cm length 16494A-005 4 m length 16494B Kelvin triaxial cable (between B2200 inputs and 4142B, between B2210/B2211 outputs and 16495F/G) 16494B-001 1.5 m length 16494B-002 3 m length 16494B-003 80 cm length 16494C Kelvin triaxial cable (between B2210/B2211 outputs and B2220A) 16494C-001 1.
Introduction Accessories and Options 1-18 Agilent B2200 User’s Guide, Edition 2
2 Installation
Installation This chapter describes requirements to install Agilent B2200 and the tasks for installation, and is organized into the following three sections: WARNING • “Requirements” • “Inspection” • “Installing the B2200” • “Self-Test” • “Output Connections” • “Input Connections” • “Measurement Cable Length” • “Maintenance” The maximum input voltage of the Agilent B2200 is ±200 V. And dangerous voltages may be present at the output terminals.
Installation Requirements Requirements This section describes the following requirements for the Agilent B2200. • “Power Requirements” • “Power Cable” • “Operating Environment” • “Storage and Shipping Environment” Power Requirements CAUTION Before applying ac line power to the Agilent B2200, ensure that the correct power cable is used. The Agilent B2200 can operate from any single-phase ac power source supplying 90 to 264 V in the frequency range from 47 to 63 Hz.
Installation Requirements Table 2-1 Power Cable • • • • • • • Plug: BS 1363/A, 250 V, 10 A Cable: 8120-1351 Plug: NEMA 5-15P, 125 V, 10 A Cable: 8120-1378 Plug: SR 107-2-D, 250 V, 10 A Cable: 8120-2956 • • • • 2-4 Plug: Argentine Resolution 63, Annex IV, 250 V, 10 A Cable: 8120-6870 Plug: NEMA 6-15P, 250 V, 6 A Cable: 8120-0698 • • • • • • • • Plug: AS 3112, 250 V, 10 A Cable: 8120-1369 • • Plug: IEC 83-B1, 250 V, 10 A Cable: 8120-4211 Plug: CEI 23-16, 250 V, 10 A Cable: 8120-6978 • •
Installation Requirements WARNING For protection from electrical shock, the power cable ground must not be defeated. Operating Environment The Agilent B2200 must be operated within the following environmental conditions: • Temperature: 5 °C to 35 °C • Humidity: 5 % to 70 % R.H.
Installation Inspection Inspection CAUTION Before Opening Packing Materials The Agilent B2200 contains the condensation sensitive electronic parts. The condensation will have a negative impact on the Agilent B2200 to operate normally. Do not open the packing materials, and leave the Agilent B2200 to acclimate it to the installation environment (temperature and humidity). If it is opened without enough acclimation, the Agilent B2200 may damage.
Installation Installing the B2200 Installing the B2200 This section describes how to install the Agilent B2200. 1. See “Requirements” on page 2-3, and determine the installation location. 2. Unpack the Agilent B2200 and place it at the installation site. 3. Plug the power cable into the Line input receptacle at the rear panel. 4. Plug the power cable into the power receptacle. 5. Perform the self-test. See “Self-Test” on page 2-10. 6.
Installation Installing the B2200 To Set the GPIB Address Every device on the GPIB bus must have a unique address. If you need to change the GPIB address, turn the Agilent B2200 on and perform the following procedure. The new GPIB address is recognized only at power on. The Agilent B2200 leaves the factory with the GPIB address set to 22. 1. Press the Menu key. 2. Move the cursor to CONFIG, then press the Enter key. 3. Move the cursor to ADDRESS, then press the Enter key.
Installation Installing the B2200 To Install the Switch Module WARNING To prevent electrical shock, turn off the mainframe and remove the power cable before starting the instruction. CAUTION Be careful about the module pins used for internal connection to the Agilent B2200. The pins can be damaged easily. Use clean handling and anti-static procedures when removing, configuring, and installing the switch modules. The modules contain components that can be damaged by static electricity.
Installation Self-Test Self-Test NOTE To confirm the specifications The self-test and diagnostics checks the operation of the mainframe and the modules. However they cannot confirm if the Agilent B2200 satisfies its specifications. For verifying the specifications, contact your nearest Agilent Technologies Service Center. Trained service personnel will perform calibration (performance verification). It is recommended to perform calibration once a year at least.
Installation Output Connections Output Connections This section describes how to connect the Agilent B2200 outputs to prober, connector plate, test fixture, and so on (DUT interface). NOTE • “Output Connectors” • “Connector Plates” • “To Make Connections to DUT Interface” • “To Make Interlock Circuit” • “To Mount Connectors” Output Connections If you do not use the connector plate for the connection between the output and the DUT interface, see “To Mount Connectors” on page 2-18.
Installation Output Connections Connector Plates Connector plates (Table 2-2) are used for the connection between the Agilent B2200 outputs and the DUT interface (prober and so on). To connect to the connector plate, use the cable shown in Table 2-3. Table 2-2 Connector Plate Agilent Model No. 16495F Description Half size connector plate 16495F-001 has 12 triaxial through connectors (female to female), an Intlk connector, and a GNDU connector (triaxial through, female to female).
Installation Output Connections For Kelvin connection, use Kelvin triaxial cable listed in Table 2-3.
Installation Output Connections Table 2-4 Connection to the DUT Interface Kelvin connections non-Kelvin connections This connection is available only for the Kelvin connectors. Following connection is for the Kelvin connectors. For the triaxial connectors, ignore SENSE terminal, and make connection only for FORCE terminal. Measurement data will include residual resistance from the connection cable.
Installation Output Connections To Make Interlock Circuit The interlock circuit is to prevent electric shock when touching measurement terminals. You must install an interlock circuit on shielding box to prevent dangerous voltages when door of the shielding box is open. Figure 2-3 shows the pin assignments of the interlock connector.
Installation Output Connections Dimensions of Interlock Switch (Agilent part number 3101-0302) 4.75 4.3 10.3 2.8 Figure 2-4 2.8 6.35 3.1 6.5 18.8 5.5 10.3 NC NO 15.9 Max 9 15.2 2.8 8.1 2.8 Switch off Switch on 59.4 COM 3.1 22.2 27.8 Units: mm Figure 2-5 10 37.8 UGI01011,85x60 Dimensions of Interlock Switch (Agilent part number 3101-3241) 10.2 4.3 27.5 10.9 3.1 3.2 Switch off Switch on 2.0 15.9 3.4 Units: mm 27.8 6.
Installation Output Connections The 4155/4156 semiconductor parameter analyzer's Intlk connector provides the interlock signal and a LED drive signal. If a LED is connected between pin 4 and pin 5 (or 6) of the interlock connector, the LED lights to indicate high voltage output when more than ±40 V is forced from an SMU in the 4155/4156. Dimensions of LED (Agilent part number 1450-0641) 11 5 Anode(+) 10 6 Cathode(-) Figure 2-6 5 5.
Installation Output Connections NOTE To Check Interlock Circuit If you use the 4155/4156, you can easily check the interlock circuit as follows: 1. Connect the Intlk connector of the 4155/4156 to your interlock circuit. 2. Press System front-panel key, then select CALIB/DIAG primary softkey to display the SYSTEM: SELF-CALIBRATION/DIAGNOSTICS page. 3. In the CALIB/DIAG field, select DIAG secondary softkey. 4. In the CATEGORY field, select I/O PERIPH secondary softkey. 5. Move pointer to the 403 (INT.
Installation Output Connections Table 2-5 Recommended Parts Description Interlock Connector (6 pin, female) 1252-1419C Switch 3101-0302 or 3101-3241 LED (VF @ 2.1 V @ IF = 10 mA) 1450-0641 Wire 8150-5680 Triaxial Connector (female) 1250-2457 Low Noise Coaxial Cable 8121-1191 Dimensions of Connector Holes Triaxial Connector (in mm) Interlock Connector (in mm) ∅11.3 1.8 8.2 5.1 10.3 Table 2-6 Agilent Part No. Kelvin Triaxial Connector (in mm) 14 11 11 14 2.8 10.3 2 − ∅11.3 ∅3.
Installation Input Connections Input Connections This section explains how to connect instruments to the Agilent B2200. WARNING Turn off all instruments that will be connected to the Agilent B2200. And do not turn them on until the connection described in this section is completed. If you ignore this warning, you may be exposed to dangerous voltage. The Agilent B2200 input connector has eight SMU input connectors and six AUX input connectors.
Installation Input Connections Table 2-7 B2200 Input Connections Instrument Application DC Measurement Agilent Model No.
Installation Input Connections Instrument Application DC Measurement Agilent Model No.
Installation Measurement Cable Length Measurement Cable Length This section describes how to calculate the total guard capacitance when using an SMU (source monitor unit). When using an SMU, the length of measurement cables is limited by the guard capacitance of the cables. The guard capacitance means the capacitance between the signal line (Force or Sense) and the Guard line. Table 2-8 lists the guard capacitance for each element of the Agilent B2200’s measurement environment.
Installation Measurement Cable Length Table 2-8 Guard Capacitances of B2200 Measurement Environment (Typical) Cable Length Guard Capacitance 16494A-003 (for non-Kelvin) 80 cm 75 pF 16494A-001 (for non-Kelvin) 1.5 m 130 pF 16494B-003 (for Kelvin, 4142B) 80 cm 90 pF 16493K-001 (for Kelvin) 1.
Installation Maintenance Maintenance Maintenance should be performed periodically to keep the B2200 in good condition. Calibration Calibration must be performed periodically so that the instruments satisfy the specifications, and keep a good condition. It is recommended to perform a calibration once a year at least. For calibration, contact your nearest Agilent Technologies Service Center. Trained service personnel will perform calibration (performance verification).
Installation Maintenance 2-26 Agilent B2200 User’s Guide, Edition 2
3 Front Panel Operation
Front Panel Operation This chapter explains the front panel operation and the switch control functions of the Agilent B2200, also provides the reference information of the front panel keys and display.
Front Panel Operation Operation Operation This section describes operations of the Agilent B2200.
Front Panel Operation Operation To Initialize Agilent B2200 1. Press the Shift key and the Local key. Then the LCD will display NO. 2. Press the arrow key to displays YES, then press the Enter key to initialize the Agilent B2200, or press the Exit key to cancel initialization. To Enable Light Pen Turn the Agilent B2200 off, and connect the light pen to the Light Pen connector at the right down corner of the front panel. After that, perform the following procedure to enable the light pen. 1.
Front Panel Operation Operation To Change Connection Rule 1. Press the Rule key. The LCD displays the present setting (FREE or SINGLE). 2. Press the arrow key to select the connection rule, then press the Enter key. Or press the Exit key to cancel this operation. To Change Connection Sequence 1. Press the Shift key and the Rule key. The LCD displays the present setting (Break_Before_Make, Make_Before_Break, or No_Sequence). 2.
Front Panel Operation Operation To Open All Switches 1. Press the Open All key. 2. Press the arrow key to display YES, then press the Enter key. NOTE Status after this operation When the bias mode is ON, the bias-enabled output ports will be connected to the input bias port. When the ground mode is ON, the ground-enabled input/output ports will be connected to the input ground port. To Save/Load Setup Data The Agilent B2200 provides the internal memory used to save the setup condition.
Front Panel Operation Operation To Use Bias Mode Bias mode cannot be set to ON when the ground mode is ON. 1. Change the bias-enabled output ports. a. Press the Shift key and the Port Function key. b. Move the cursor to SET, then press the Enter key. c. Move the cursor to DISABLE, then press the Enter key. The LCD displays one of the bias-enabled output port numbers which can be changed to the bias-disabled. Or if there is no bias-enabled output port, the LCD displays Channel: No Channel.
Front Panel Operation Operation To Use Ground Mode Ground mode cannot be set to ON when the bias mode is ON. 1. Change the ground-enabled output ports. a. Press the Shift key and the Open All key. b. Move the cursor to SET, then press the Enter key. c. Move the cursor to ENABLE, then press the Enter key. The LCD displays one of the ground-disabled output port numbers which can be changed to the ground-enabled. Or if there is no ground-disabled output ports, the LCD displays Channel: No Channel.
Front Panel Operation Operation To Use Couple Mode 1. Press the Couple Mode key to set the couple mode ON. Pressing the key again sets the mode OFF. 2. Perform the input couple port detection. a. Press the Menu key. The setup menu will be displayed on the LCD. b. Move the cursor to SCAN, then press the Enter key. The LCD displays NO. c. Press the arrow key to display YES, then press the Enter key. d. Press the Exit key. 3. Change the couple ports (multiple ports can be set). a.
Front Panel Operation Operation To Read Error Message 1. Press the Menu key. The setup menu will be displayed on the LCD. 2. Move the cursor to ERROR, then press the Enter key. 3. Move the cursor to DISPLAY, then press the Enter key to display the message. 4. Press the arrow keys to read another error message. A maximum of four error messages can be stored. To clear error buffer 1. Press the Menu key. The setup menu will be displayed on the LCD. 2. Move the cursor to ERROR, then press the Enter key. 3.
Front Panel Operation Operation To Set Remote Display Mode This instruction enables or disables the data display in the GPIB remote condition. See “RMT_DSPL” on page 3-33. LCD 1. Press the Menu key. The setup menu will be displayed on the LCD. 2. Move the cursor to RMT_DSPL, then press the Enter key. 3. Move the cursor to LCD, then press the Enter key. 4. Press the arrow keys to set the remote display mode ON or OFF. 5.
Front Panel Operation Switch Control Functions Switch Control Functions This section introduces the switch control functions of the Agilent B2200.
Front Panel Operation Switch Control Functions Channel Configuration Mode The Agilent B2200 provides the two channel configuration modes, Normal and Auto. The configuration mode defines the way to control multiple switch modules installed in the mainframe. Normal Each module is considered independently. So each module is always a 12 output switching matrix. The switch control functions need to be defined for each module. Auto Default mode at Power On or *RST command.
Front Panel Operation Switch Control Functions Connection Rule Connection rule is used to specify if an input or output port can have multiple connections. For each module installed in the mainframe (for auto configuration mode, installed modules are treated as one module), you can specify one of the following connection rules: Single: Each input port can be connected to only one output port, and each output port can be connected to only one input port.
Front Panel Operation Switch Control Functions Connection Sequence NOTE This is only for modules that are set to the single connection rule. Refer to “Connection Rule” on page 3-14. Connection sequence specifies the open/close sequence of the relays when changing from an existing connection to a new connection. You can select one of the three connection sequences shown in Table 3-1 for each module installed in the Agilent B2200.
Front Panel Operation Switch Control Functions Bias Mode Bias mode is useful for connecting the same input to multiple channels (output ports) simultaneously. And the connections will be kept until the other input port connection will be changed. When the bias mode is ON, the input bias port is connected to all bias enabled output ports that are not connected to any other input ports.
Front Panel Operation Switch Control Functions NOTE Connection rule cannot be specified for the input bias port, which can always be connected to multiple output ports. Connection sequence (to connect input bias port to output ports) is always Break-Before-Make. Bias mode cannot be set to ON when the ground mode is ON. If the bias input port and a couple port have been assigned to the same input port, the bias mode and the couple mode cannot be used in parallel.
Front Panel Operation Switch Control Functions Ground Mode Ground mode operation is similar to the bias mode operation. The ground mode is useful for connecting the same input to multiple channels (output ports) and the unused input ports simultaneously. And the connections will be kept until the other input port connection will be changed. The ground mode is especially useful for settling the potential of the unused input/output paths.
Front Panel Operation Switch Control Functions CAUTION Opening the ground enabled input ports Open the ground enabled input ports (unused input ports). If any equipment is connected to the ground enabled input ports, turning the ground mode ON may cause damage in the equipment.
Front Panel Operation Switch Control Functions Couple Mode Couple mode is useful for making the Kelvin connections. When the couple mode is ON, the input couple ports will be connected to the output couple ports. For the available couple ports, see Table 3-2. Table 3-2 • For the couple port connections, the odd/even number of the input port will be connected to the odd/even number of the output port respectively. Then the even number is always the odd number plus 1.
Front Panel Operation Switch Control Functions NOTE Couple Port Detection Function The Agilent B2200 provides the function to detect the input ports that connect the Kelvin triaxial cable and set the ports as the couple port automatically.
Front Panel Operation Display Functions Display Functions The Agilent B2200 provides LED matrix, LCD, and 18 front panel keys for front panel operation. This section explains the display of the LED matrix and the LCD. • “LED Matrix” • “LCD” LED Matrix Agilent B2200 has four blocks of 14 × 12 LED matrix. They display the switch condition of the switch modules installed in the slot 1 to slot 4. See Table 3-3. Also LEDs labeled Card 1 to Card 4 are located above the LED matrices.
Front Panel Operation Display Functions LCD The LCD displays the setup information and the status information as shown in Table 3-5. Display example is shown in Figure 3-2. Figure 3-2 LCD Display Example 01 02 03 04 05 06 07 08 09 10 11 12 13 14 Shift -CCG FREE BBM A Lock Error Bias Gnd Rule Sequence The first line shows the input port status, couple port, bias port, ground port, or ground enabled port. The second line shows the instrument status and the mode status.
Front Panel Operation Display Functions Table 3-5 LCD Display Items Label 01 to 14 Port function assigned to the input ports 1 to 14. B (bias port), C (couple port), G (ground port), - (ground enabled port), or blank (no function). Shift Shift key status indicator. The triangle mark appears when the sub key is active. Remote Remote status indicator. The triangle mark appears when the Agilent B2200 is in the GPIB remote condition. Lock Key status indicator.
Front Panel Operation Front Panel Keys Front Panel Keys The Agilent B2200 provides LED matrix, LCD, and 18 front panel keys for front panel operation. The front panel keys are used to change the instrument settings, the switch conditions, and so on. Function Local Sets the Agilent B2200 to the local condition. Reset (Shift+Local) Used to reset the Agilent B2200. Edit Displays the following message. Press the arrow key to set YES, and then press the Enter key to reset the instrument.
Front Panel Operation Front Panel Keys Function key group The Function key group is used to change the input ports and modes. Function Port Function Edit Enters into the port function selection mode. In this mode, the arrow keys, Fast key, Exit key, and Enter key are available. Other keys will work to exit this mode.
Front Panel Operation Front Panel Keys Bias Mode Sets the bias mode ON or OFF. When the bias mode is set to ON, the LCD shows which input port is the bias port, and the input bias port will be connected to the bias-enabled channels that are not connected to other input port. And LEDs will be turned red to show the bias port connections. Ch Mode (Shift+ Bias Mode) Sets the channel configuration mode AUTO or NORMAL. Couple Mode Sets the couple mode ON or OFF.
Front Panel Operation Front Panel Keys Gnd Ch (Shift+Open All) Displays the following menu. SET • VIEW SET displays the following menu. The following functions are used to set the ground-enabled or ground-disabled channel (output port). ENABLE DISABLE The function displays the following message for example. And then press Enter to ground-enable or ground-disable the channel. Channel: 01 If there is no enabled or disabled channel, the following message will appear.
Front Panel Operation Front Panel Keys Edit key group The Edit key group is used to select the switch module to be monitored, move the cursor in the display, make the setup value effective, return to the previous menu or display, and so on. Function Card Selection Edit Selects the switch module to be monitored on the LCD. The Card# status indicator will change the slot number (card number) when the Card Selection key is pressed.
Front Panel Operation Setup Menus Setup Menus This section explains the following setup menus displayed by pressing the Menu key or Selftest key. • “Setup Menu” • “Selftest Menu” Setup Menu Press the Menu key. The setup menu will be displayed on the LCD as shown in the following example. The setup menu is used to change the GPIB address, detect the couple port automatically, and so on.
Front Panel Operation Setup Menus Function Tree The setup menu provides the following functions. • CONFIG • ADDRESS • REVISION Displays the firmware revision. • UNIT • SCAN • ERROR • Sets the GPIB address. Displays the module information of each slot. Detects and sets the input couple ports automatically. • DISPLAY Displays the error code and error message. • CLEAR Clears the error buffer. RMT_DSPL • LCD Selects on or off for the LCD display in the remote mode.
Front Panel Operation Setup Menus CONFIG Displays the sub menu that provides the following functions. • ADDRESS Displays the following message. GPIB Address = Address Press the arrow key to set the desired GPIB address. Then, press the Enter key to make the setup effective, or press the Exit key to cancel changing the setup. • REVISION Displays the following message. X.XX.XX where X.XX.XX shows the firmware revision. To return to the previous menu, press the Exit key.
Front Panel Operation Setup Menus ERROR Displays the sub menu that provides the following functions. • DISPLAY Displays the error code and error message, or No Error. To return to the previous menu, press the Exit key. • CLEAR Displays the following message. Press the arrow key to set YES. Then, press the Enter key to clear the error buffer, or press the Exit key to cancel this operation. NO RMT_DSPL Displays the sub menu that provides the following functions. • LCD Displays the following message.
Front Panel Operation Setup Menus Selftest Menu Press the Shift key and the Menu key. The selftest menu is displayed. The menu is used to execute the selftest and diagnostics. [Execute Diagnostics] SELF_TEST RELAY_TEST [Execute Diagnostics] GPIB Press the arrow key to move the cursor to the desired function name. Then, press the key. The setup message or the sub menu will be displayed. To return to the previous menu, press the Exit key.
Front Panel Operation Setup Menus SELF_TEST Displays the sub menu that provides the following functions. • EXECUTE Starts the controller test. Wait until PASS or FAIL is displayed. Then press the key to return to the previous menu. Exit • RESULT Displays the test result. Press the Exit key to return to the previous menu. RELAY_TEST Displays the sub menu that provides the following functions. Before starting the relay test, disconnect cables from the input connectors.
Front Panel Operation Setup Menus KEY Displays the sub menu that provides the following functions. • EXECUTE Displays the following message. DIAG:KEY Press any key. Press any front panel key and confirm the LCD display. For example, if you press the Port Function key, the following message must be displayed. DIAG:KEY [Port Function] Continue this for all keys. After that, press the Enter key twice for the normal operation. The test result will be PASS.
Front Panel Operation Setup Menus LED Displays the sub menu that provides the following functions. • EXECUTE Starts the LED matrix test, and displays the following message. DIAG:LED All LED in Orange? Press the Enter key if the all LEDs are lighted in orange. The test result will be recorded as PASS. If you find any problem, press the Exit key. The test result will be recorded as FAIL. Finally, press the Exit key to return to the previous menu. • RESULT Displays the test result.
Front Panel Operation Setup Menus GPIB Displays the sub menu that provides the following functions. • EXECUTE Displays the following message. Open GPIB, then press [Enter] Disconnect the cable from the GPIB connector on the rear panel, and open it. Press the Enter key to start the GPIB test, and wait until PASS or FAIL is displayed. Then press the Exit key to return to the previous menu. • RESULT Displays the test result. Press the Exit key to return to the previous menu.
4 Programming
Programming This chapter describes the automatic control programming of the Agilent B2200. • “Programming Basics” Explains the commands for the fundamental switch control of the Agilent B2200. • “Programming Examples” Provides some examples of the programming. • “Capacitance Compensation” Explains how to use the capacitance compensation routine. The routine is a function of the Agilent B2200 VXIplug&play driver. For the details about SCPI commands, see Chapter 5.
Programming Programming Basics Programming Basics This section explains the commands used for the fundamental switch control of the Agilent B2200. • “SCPI Command Hierarchy” • “Fundamental Commands” • “Switch Control” SCPI Command Hierarchy The SCPI commands use a hierarchical structure for subsystem commands similar to a file system.
Programming Programming Basics Fundamental Commands The following commands are used to set the fundamental switch control functions of the Agilent B2200. The commands should be entered before performing the open/close operation. For the functions, see “Switch Control Functions” on page 3-12. Table 4-1 Fundamental Commands Functions Commands Sets the channel configuration mode. :ROUT:FUNC NCON Sets the connection rule.
Programming Programming Basics Switch Control The following commands are used to control open/close of the specified switch. Table 4-2 Switch Control Commands Functions Commands Closes the relays specified by channel_list. :ROUT:CLOS channel_list Opens the relays specified by channel_list. :ROUT:OPEN channel_list Opens the all relays on the card specified by card_no. :ROUT:OPEN:CARD card_no The channel_list is the parameter which determines the input-output cross points to open/close.
Programming Programming Basics In the channel_list, you can specify multiple channels by using comma (,) or colon (:) as follows: Comma: use between each specified channel as in following examples: • (@10101,10102,10103) means 10101, 10102 and 10103. • (@10112,10202) means 10112 and 10202. • (@11412,20102) means 11412 and 20102. Colon: use to specify a range of channels as in following examples: • (@10101:10103) means 10101, 10102, and 10103. • (@10112:10202) means 10112, 10201, and 10202.
Programming Programming Examples Programming Examples This section provides examples of control programs for the Agilent B2200. NOTE • “Connecting Input-Output Paths” • “Using Bias Mode” • “Using Ground Mode” • “Using Couple Mode” • “Saving Input/Output Labels” • “Defining Comment for Internal Memory” Executing the program Example programs use the Microsoft Visual Basic .NET and the Agilent T&M Programmers Toolkit.
Programming Programming Examples Connecting Input-Output Paths The following example connects instrument output to DUT as shown in Figure 4-2. Figure 4-2 Input-Output Connection Example Setup: • Channel configuration mode: Normal • Connection rule: Single • Connection sequence: Break_Before_Make • Display strings: “Connecting MOSFET AG002201” • Used module: Switch module installed in the slot 1.
Programming Programming Examples Table 4-3 Input-Output Connection Example Imports Agilent.TMFramework Imports Agilent.TMFramework.InstrumentIO Module Module1 Sub Main() Dim B2200 As New DirectIO("GPIB0::22::INSTR") Dim channels As String = "(@10101,10202,10303,10404)" B2200.WriteLine("*RST") B2200.WriteLine(":ROUT:FUNC NCON") B2200.WriteLine(":ROUT:CONN:RULE ALL,SROU") B2200.WriteLine(":ROUT:CONN:SEQ ALL,BBM") B2200.WriteLine(":SYST:DISP:STR 'Connecting MOSFET AG002201'") B2200.
Programming Programming Examples Using Bias Mode The following example uses the bias mode. Figure 4-3 Bias Mode Example Setup: • Channel configuration mode: Auto • Connection rule: Single. Multiple connection is available for the bias port. • Connection sequence: Break_Before_Make • Used module: All switch modules installed in the mainframe.
Programming Programming Examples Table 4-4 Bias Mode Example Imports Agilent.TMFramework Imports Agilent.TMFramework.DataAnalysis Imports Agilent.TMFramework.DataVisualization Imports Agilent.TMFramework.InstrumentIO Module Module1 Sub Main() Dim B2200 As New DirectIO("GPIB0::22::INSTR") Dim channels As String = "(@101,202,303,404)" B2200.WriteLine("*RST") B2200.WriteLine(":ROUT:FUNC ACON") B2200.WriteLine(":ROUT:CONN:RULE ALL,SROU") B2200.WriteLine(":ROUT:CONN:SEQ ALL,BBM") B2200.
Programming Programming Examples Using Ground Mode The following example uses the ground mode. Figure 4-4 Ground Mode Example Setup: • Channel configuration mode: Auto • Connection rule: Single. Multiple connection is available for the ground port. • Connection sequence: Break_Before_Make • Used module: All switch modules installed in the mainframe.
Programming Programming Examples Table 4-5 Ground Mode Example Imports Agilent.TMFramework Imports Agilent.TMFramework.DataAnalysis Imports Agilent.TMFramework.DataVisualization Imports Agilent.TMFramework.InstrumentIO Module Module1 Sub Main() Dim B2200 As New DirectIO("GPIB0::22::INSTR") Dim channels As String = "(@101,202,303,404)" B2200.WriteLine("*RST") B2200.WriteLine(":ROUT:FUNC ACON") B2200.WriteLine(":ROUT:CONN:RULE ALL,SROU") B2200.WriteLine(":ROUT:CONN:SEQ ALL,BBM") B2200.
Programming Programming Examples Using Couple Mode The following example uses the couple mode. Figure 4-5 Couple Mode Example Setup: • Channel configuration mode: Auto • Connection rule: Single • Connection sequence: Break_Before_Make • Used module: All switch modules installed in the mainframe.
Programming Programming Examples Table 4-6 Couple Mode Example Imports Agilent.TMFramework Imports Agilent.TMFramework.DataAnalysis Imports Agilent.TMFramework.DataVisualization Imports Agilent.TMFramework.InstrumentIO Module Module1 Sub Main() Dim B2200 As New DirectIO("GPIB0::22::INSTR") Dim channels As String = "(@101,202,303,505)" B2200.WriteLine("*RST") B2200.WriteLine(":ROUT:FUNC ACON") B2200.WriteLine(":ROUT:CONN:RULE ALL,SROU") B2200.WriteLine(":ROUT:CONN:SEQ ALL,BBM") B2200.
Programming Programming Examples Saving Input/Output Labels You can define labels to use for the input/output ports when you control the switch in the GPIB local mode. The labels are cleared by *RST. So it is recommended to save the labels into the internal memory and define a comment for the memory data. You can see the comment when you load/save the memory data in the GPIB local mode.
Programming Programming Examples Table 4-7 Label Definition and Data Save Example Imports Agilent.TMFramework Imports Agilent.TMFramework.InstrumentIO Module Module1 Sub Main() Dim B2200 As New DirectIO("GPIB0::22::INSTR") B2200.WriteLine("*RST") B2200.WriteLine(":ROUT:FUNC ACON") Console.WriteLine("Starts labeling." & Chr(10)) B2200.WriteLine(":SYST:DISP:STR 'Updating memory 1 data.'") B2200.WriteLine(":ROUT:SYMB:PORT 1,'SMU1 '") B2200.WriteLine(":ROUT:SYMB:PORT 2,'SMU2 '") B2200.
Programming Programming Examples Defining Comment for Internal Memory You can define comments for the internal memories. You can see the comment when you load/save the memory data in the GPIB local mode.
Programming Programming Examples Table 4-8 Memory Comment Definition Example Imports Agilent.TMFramework Imports Agilent.TMFramework.DataAnalysis Imports Agilent.TMFramework.DataVisualization Imports Agilent.TMFramework.InstrumentIO Module Module1 Sub Main() Dim B2200 As New DirectIO("GPIB0::22::INSTR") B2200.WriteLine("*RST") B2200.WriteLine(":ROUT:FUNC ACON") Console.WriteLine("Starts labeling." & Chr(10)) B2200.WriteLine(":SYST:DISP:STR 'Updating memory comment.'") B2200.
Programming Capacitance Compensation Capacitance Compensation When the capacitance/conductance measurement is performed through the Agilent B2200, LCR meter measures the capacitance/conductance of the path including a device under test (DUT), matrix switches, extension cables and so on. So, the data measured by the LCR meter is far from the DUT’s capacitance/conductance.
Programming Capacitance Compensation Required Conditions The following conditions must be satisfied to use the capacitance compensation function. For the instrument connections, see Figure 4-6. • Setting of the 4284A • Option required: 4284A-006 • Range of the measurement frequency: 1 kHz to 1 MHz • Measurement function: Cp-G • Connection to Agilent B2200 Use the Agilent 16494F CMU cable or the Agilent 16048D/E test leads to connect between the Agilent 4284A and the Agilent B2200 inputs.
Programming Capacitance Compensation In Figure 4-6, C2H, C2L, C3H, C3L are the compensation coefficients defined in the compensation data file. where, CxH is for the path connected to the Agilent 4284A Hc-Hp terminal, and CxL is for the path connected to the Agilent 4284A Lc-Lp terminal. When the Agilent B2220A probe card interface is used, obtain the coefficients for C3x, and create your compensation data file. In this case, probe card will be used for the C3x path.
Programming Capacitance Compensation To Create Compensation Data File This section explains how to create the compensation data file. 1. Select one of the compensation data files (template, 20 files) installed when the Agilent B2200 VXIplug&play driver is installed. To select the most appropriate template for your measurement environment, see Table 4-9 that lists the file name and the measurement environment where the template targets.
Programming Capacitance Compensation Table 4-9 Template Compensation Data Files Measurement environment that template targets File namea \B2210A\pcif\triax\3m.data Switch module Cableb DUT interfacec Coefficients to be modified B2210A 16494A-002 B2220A C3H and C3L 16495F/G C2H, C2L, C3H, and C3L B2220A C3H and C3L 16495F/G C2H, C2L, C3H, and C3L \B2210A\pcif\triax\4m.data 16494A-005 \B2210A\pcif\kelvin\3m.data 16494C-002 \B2210A\pcif\kelvin\4m.
Programming Capacitance Compensation Table 4-10 Compensation Coefficients and Modifications Compensation coefficients C2H C2L Modifications of data file For the Agilent B2220A probe card interface, do not modify the lines. For the connector plate, change the R, L, C values in the lines. The value must be changed to the R, L, C values of the C2x path (triaxial cable with connector plate) shown in Figure 4-6. C3H C3L Change the R, L, C values in the lines.
Programming Capacitance Compensation To obtain compensation coefficients Obtain the compensation coefficients as shown below. 1. Select the measurement frequency (Fmeas) used for the capacitance measurement of a device under test (DUT), and set it to the Agilent 4284A. The coefficients must be measured at the same frequency. 2. Perform the Agilent 4284A open calibration at the measurement terminal. Optionally, perform short calibration if you want. 3.
Programming Capacitance Compensation To Perform Measurement and Compensation Perform the capacitance measurement and compensation as shown below. 1. Set the Agilent 4284A measurement condition. Then the frequency must be the value (Fmeas) used when the compensation coefficients are measured. 2. Before contacting the device under test (DUT), perform the Cp-G measurement in the open condition at the end of the measurement path including positioner or probe card, and record the measurement data (C1 and G1).
Programming Capacitance Compensation Table 4-13 Capacitance Compensation Program Example Imports Agilent.TMFramework Imports Agilent.TMFramework.DataAnalysis Imports Agilent.TMFramework.DataVisualization Imports Agilent.TMFramework.InstrumentIO Imports Agilent.TMFramework.InstrumentDriverInterop Imports Agilent.TMFramework.InstrumentDriverInterop.Design Imports Agilent.TMFramework.InstrumentDriverInterop.
5 SCPI Command Reference
SCPI Command Reference This chapter describes the following for Agilent B2200: • SCPI commands available to control the B2200 via GPIB interface. SCPI is a universal programming language for electronic test and measurement instruments, and is based on IEEE 488.1 and IEEE 488.2. SCPI commands are divided into two types: common commands and subsystem commands. Common commands are generally not measurement related, but are used to manage status registers, data storage, and so on.
SCPI Command Reference Textual Notation for Subsystem Commands CAPITAL LETTERS Capital letters are the minimally required letters of the command header. Lowercase letters are the long form (complete spelling), which you can omit if desired. For example, for :SYSTem:CCONfig?, you only need to specify :SYST:CCON?. [] Square brackets are used to enclose optional information not required for execution of the command sequence.
SCPI Command Reference Commands Summary Common Commands This section describes common commands and queries, which are commands defined by IEEE 488.2. Commands Summary The following table shows some common commands that are supported for the B2200.
SCPI Command Reference *CLS *CLS This command clears the Status Byte Register, the Standard Event Status Register, and the Error Queue. This command does not clear the enable registers. See “Status Reporting Structure” on page 5-53. Also, this command stops the monitoring of pending operations by the *OPC command. This command does not have query form. Syntax *CLS Example OUTPUT @Agb2200;"*CLS" *ESE This command sets the bits of the Standard Event Status “Enable” Register. 1 enables, 0 masks.
SCPI Command Reference *ESR? The following table shows the bits of the Standard Event Status Register and binary-weighted decimal value of each bit.
SCPI Command Reference *IDN? Semantics Example The following table shows the bits of the Standard Event Status Register, and the binary-weighted decimal value of each bit. bit binary-weight description 0 1 OPC (Operation Complete) 1 2 not used. always 0. 2 4 QYE (Query ERROR) 3 8 DDE (Device-Dependent ERROR) 4 16 EXE (Execution ERROR) 5 32 CME (Command ERROR) 6 64 not used. always 0.
SCPI Command Reference *OPC *OPC This command starts to monitor pending operations, and sets/clears the Operation Complete (OPC) bit in the Standard Event Status Register as follows: • If there is no pending operation, sets the OPC bit to 1. • If there are any pending operations, sets the OPC bit to 0. The bit will be set to 1 again when all pending operations are completed. So, *OPC command is required to enable the OPC bit.
SCPI Command Reference *RST *RST This command performs an instrument reset. Status after *RST is shown below: Channel Configuration: Auto configuration mode Connection Rule: Free Connection Sequence: Break Before Make Bias Mode: Off Bias Input Port: 10 Bias-enabled Channels: All channels (output ports) are bias-enabled. Couple Mode: Off Couple Input Port: Cleared. Ground Mode: Off Ground Input Port: 12 Ground-enabled Channels: Cleared. Ground-enabled Ports: Cleared.
SCPI Command Reference *SRE *SRE This command sets the Service Request “Enable” Register bits. 1 enables, 0 masks. Syntax *SRE enable_number Parameter Explanation enable_number decimal integer (that is the sum of the binary-weighted values for the desired bits), hexadecimal, octal, or binary value Query response enable_number <^END> Semantics The Service Request “Enable” Register consists of 8 bits: Bit0 to Bit7. Bit6 is not defined, and is always 0.
SCPI Command Reference *STB? The following is example for query: OUTPUT @Agb2200;"*SRE?" ENTER @Agb2200;A *STB? This query command reads the Status Byte Register (reads Master Summary Status bit, not Request for Service Message). For bit6, this command reads MSS, not Request for Service (RQS). See “Status Reporting Structure” on page 5-53.
SCPI Command Reference *TST? *TST? This query command executes an internal self-test, then returns the result. After this command execution, the B2200 becomes same status as after *RST command execution. Syntax *TST? Query response test_result <^END> test_result Example Explanation 0 pass 1 fail OUTPUT @Agb2200;"*TST?" ENTER @Agb2200;A *WAI This command stops execution of any commands until the Operation Complete (OPC) bit is set to 1, which means there is no pending operation.
SCPI Command Reference Command Summary Subsystem Commands Command Summary ROUT subsystem :ROUTe subsystem has commands for controlling the signal routing. “Open a channel”: opens relays to disconnect the channel (that is, disconnects input port from output port). “Close a channel”: closes relays to connect the channel (that is, connects input port to output port). Command [:ROUT]:FUNC channel_config [:ROUT]:FUNC? Description Sets the channel configuration mode.
SCPI Command Reference Command Summary Command [:ROUT]:SYMB:CHAN card_number,channel,'string' [:ROUT]:SYMB:CHAN? card_number,channel Description Defines a string for the specified channel. card_number: 0 or ALL for Auto Config, 1, 2, 3, 4, or ALL for Normal Config channel: channel number, 1 to 48 for Auto, 1 to 12 for Normal Query returns the symbol string set to the specified channel. [:ROUT]:SYMB:PORT port,'string' [:ROUT]:SYMB:PORT? port Defines a string for the specified input port.
SCPI Command Reference Command Summary Command Description Bias Mode Commands [:ROUT]:BIAS:CHAN:DIS:CARD card_number Bias-disables the specified card. card_number: 0 or ALL for Auto Config, 1, 2, 3, 4, or ALL for Normal Config [:ROUT]:BIAS:CHAN:DIS[:LIST] (@channel_list) [:ROUT]:BIAS:CHAN:DIS[:LIST]? (@channel_list) Bias-disables the specified channels. channel_list: Channels to bias-disable. Query returns the status of the specified channels: 1 (disabled) or 0 (enabled).
SCPI Command Reference Command Summary Command Description Ground Mode Commands [:ROUT]:AGND:CHAN:DIS:CARD card_number Ground-disables the specified card. card_number: 0 or ALL for Auto Config, 1, 2, 3, 4, or ALL for Normal Config [:ROUT]:AGND:CHAN:DIS[:LIST] (@channel_list) [:ROUT]:AGND:CHAN:DIS[:LIST]? (@channel_list) Ground-disables the specified channels. channel_list: Channels to ground-disable. Query returns the status of the specified channels: 1 (disabled) or 0 (enabled).
SCPI Command Reference Command Summary Command [:ROUT]:AGND:UNUSED card_number,'enable_port' [:ROUT]:AGND:UNUSED? card_number Description Ground-enables the specified input ports for the specified card. card_number: 0 or ALL for Auto Config, 1, 2, 3, 4, or ALL for Normal Config enable_port: One or more input port numbers: 1 to 8. Enclose by single quotation marks. Separate multiple input port numbers by comma. For example: '1,5' Query returns the ground-enabled input port numbers for the specified card.
SCPI Command Reference Command Summary DIAG subsystem :DIAGnostic subsystem has commands for executing the self-test function. For more info, see “Selftest Menu” on page 3-34. The :DIAGnostic subsystem commands ignore the B2200 channel configuration mode. For :DIAG commands that require a card number, you specify 1, 2, 3, 4, or ALL. Command :DIAG:TEST:CARD:CLE card_number Description Clears relay test result (pass/fail) of the specified card.
SCPI Command Reference Command Summary SYSTEM subsystem :SYSTem subsystem is a collection of functions that are not related to instrument performance. Command Description :SYST:BEEP state Enables/disables the beeper. state: ON / 1 (enable) or OFF / 0 (disable) :SYST:CCON? card_number Returns the card configuration information. This command is just to keep compatibility with the Agilent E5250A.
SCPI Command Reference Command Summary Command Description :SYST:MEMO:COMM memory_number,'comment' :SYST:MEMO:COMM? memory_number Memorizes the comment for the B2200 setup information specified by memory_number. memory_number: 1 to 8 :SYST:MEMO:DEL memory_number Deletes the B2200 setup information and the comment specified by memory_number. memory_number: 1 to 8 :SYST:PEN state Enables/disables the light pen.
SCPI Command Reference :DIAGnostic:TEST:CARD:CLEar :DIAGnostic:TEST:CARD:CLEar This command clears the relay test result (pass/fail result) of the specified card. Syntax :DIAGnostic:TEST:CARD:CLEar card_number Parameter card_number Example Explanation card number: 1, 2, 3, 4, or ALL OUTPUT @Agb2200;":DIAG:TEST:CARD:CLE 1" :DIAGnostic:TEST:CARD[:EXECute]? This command executes the relay test for specified card, then returns the pass/fail result.
SCPI Command Reference :DIAGnostic:TEST:CARD:STATe? :DIAGnostic:TEST:CARD:STATe? This command returns the most recent relay test result for the specified card. Syntax :DIAGnostic:TEST:CARD:STATe? card_number Parameter card_number Query response Explanation card number: 1, 2, 3, 4 test_result <^END> 1: fail 0: pass -1: not tested Example OUTPUT @Agb2200;":DIAG:TEST:CARD:STAT? 1" ENTER @Agb2200;A :DIAGnostic:TEST:FRAMe:CLEar This command clears test result of the specified B2200 test.
SCPI Command Reference :DIAGnostic:TEST:FRAMe[:EXECute]? :DIAGnostic:TEST:FRAMe[:EXECute]? This command executes the specified B2200 test, then returns the test result. See “Selftest Menu” on page 3-34 to perform the test. After the controller test, the B2200 status becomes same as after *RST command execution.
SCPI Command Reference :DIAGnostic:TEST:FRAMe:STATe? :DIAGnostic:TEST:FRAMe:STATe? This command returns the most recent test result (pass/fail) of the specified test.
SCPI Command Reference [:ROUTe]:AGND:CHANnel:DISable[:LIST] [:ROUTe]:AGND:CHANnel:DISable[:LIST] This command specifies the ground-disabled output ports (channels). When the Ground Mode is ON, the ground-disabled output ports are disconnected from the input Ground Port. At *RST, no channel is ground-enabled. The ground mode is set by “[:ROUTe]:AGND[:STATe]”. The query returns whether the specified channels are ground-disabled or not.
SCPI Command Reference [:ROUTe]:AGND:CHANnel:ENABle[:LIST] Syntax [:ROUTe]:AGND:CHANnel:ENABle:CARD card_number Parameter card_number Example Explanation For Auto Config mode: 0 or ALL For Normal Config mode: 1, 2, 3, 4, or ALL OUTPUT @Agb2200;":ROUT:AGND:CHAN:ENAB:CARD ALL" [:ROUTe]:AGND:CHANnel:ENABle[:LIST] This command specifies the ground-enabled output ports (channels).
SCPI Command Reference [:ROUTe]:AGND:PORT [:ROUTe]:AGND:PORT This command specifies the input Ground Port for the specified card. For each card, you can specify the same or different Ground Port. At *RST, the Ground Port is 12. The ground mode is set by “[:ROUTe]:AGND[:STATe]”. The query returns the input port number of the Ground Port. NOTE The input ground port and a ground enabled input port cannot be assigned to the same input port.
SCPI Command Reference [:ROUTe]:AGND[:STATe] [:ROUTe]:AGND[:STATe] NOTE You cannot set the Ground Mode to ON when the Bias Mode is ON. This command controls the Ground Mode for the specified card. When the Ground Mode is ON, the input Ground Port is connected to the all ground-enabled input ports/output ports that have not been connected to any other port. At *RST, the Ground Mode is OFF. The query returns the mode status. The input Ground Port is set by “[:ROUTe]:AGND:PORT”.
SCPI Command Reference [:ROUTe]:AGND:UNUSED [:ROUTe]:AGND:UNUSED This command specifies the ground-enabled input ports for the specified card. When the Ground Mode is ON, the ground-enabled input ports that have not been connected to any other port are connected to the input Ground Port. At *RST, no input port is ground-enabled. The ground mode is set by “[:ROUTe]:AGND[:STATe]”. The query returns which input ports are ground-enabled.
SCPI Command Reference [:ROUTe]:BIAS:CHANnel:DISable:CARD [:ROUTe]:BIAS:CHANnel:DISable:CARD This command bias-disables the all output ports (channels) for the specified card. When the Bias Mode is ON, the bias-disabled output ports are disconnected from the input Bias Port. At *RST, all cards are bias-enabled. The bias mode is set by “[:ROUTe]:BIAS[:STATe]”.
SCPI Command Reference [:ROUTe]:BIAS:CHANnel:ENABle:CARD Example OUTPUT @Agb2200;":ROUT:BIAS:CHAN:ENAB:CARD ALL" OUTPUT @Agb2200;":ROUT:BIAS:CHAN:DIS (@10101)" OUTPUT @Agb2200;":ROUT:BIAS:CHAN:DIS? (@10101,10102,10201)" ENTER @Agb2200;A$ This example bias-disables the output port 1 on the card 1. In this example, A$ will be 1,0,1. [:ROUTe]:BIAS:CHANnel:ENABle:CARD This command bias-enables the all output ports (channels) for the specified card.
SCPI Command Reference [:ROUTe]:BIAS:PORT Input port is always the input Bias Port. So, the input ports in channel_list are ignored. However, you cannot abbreviate the input port.
SCPI Command Reference [:ROUTe]:BIAS[:STATe] In this example, A will be 4. [:ROUTe]:BIAS[:STATe] NOTE You cannot set the Bias Mode to ON when the Ground Mode is ON. This command controls the Bias Mode for the specified card. When the Bias Mode is ON, the input Bias Port is connected to the all bias-enabled output ports that have not been connected to any other input port. At *RST, the Bias Mode is OFF. The query returns the mode status of the specified card.
SCPI Command Reference [:ROUTe]:CLOSe:CARD? [:ROUTe]:CLOSe:CARD? This query command returns channel_list of all closed (connected) channels for the specified card.
SCPI Command Reference [:ROUTe]:CONNection:RULE Example OUTPUT @Agb2200;":ROUT:CLOS (@10101,10202)" OUTPUT @Agb2200;":ROUT:CLOS? (@10101,10102,10201,10202)" ENTER @Agb2200;A$ In this example, A$ will be 1,0,0,1. [:ROUTe]:CONNection:RULE This command sets the connection rule (Free or Single Route) for the specified card. The query returns the connection rule of the specified card. At *RST, all cards are set to FREE. See “Connection Rule” on page 3-14.
SCPI Command Reference [:ROUTe]:CONNection:SEQuence [:ROUTe]:CONNection:SEQuence This command specifies the connection sequence mode, which is the open/close sequence of the relays when connection route is changed from an existing connection to a new connection. The query returns the connection sequence mode of the specified card. At *RST, BBMake is selected. See “Connection Sequence” on page 3-15. The connection sequence is used only for cards that have been set to SROUte connection rule.
SCPI Command Reference [:ROUTe]:COUPle:PORT [:ROUTe]:COUPle:PORT NOTE If the input bias port and a couple port have been assigned to the same input port, the bias mode and the couple mode cannot be used in parallel. If the input ground port and a couple port have been assigned to the same input port, the ground mode and the couple mode cannot be used in parallel.
SCPI Command Reference [:ROUTe]:COUPle:PORT:DETect [:ROUTe]:COUPle:PORT:DETect This command detects the input ports connected to the Kelvin cable, and assigns them as the input couple ports that will be used for the Kelvin connection. The input couple port setting is effective for the all cards. This command overwrites the previous couple port setting. The couple mode is set by “[:ROUTe]:COUPle[:STATe]”. The couple port setting will be cleared and updated by “[:ROUTe]:COUPle:PORT”.
SCPI Command Reference [:ROUTe]:COUPle[:STATe] [:ROUTe]:COUPle[:STATe] This command controls the Couple Mode for the specified card. The query returns the mode status of the specified card. At *RST, the Couple Mode is OFF. The input couple ports are set by “[:ROUTe]:COUPle:PORT:DETect” or “[:ROUTe]:COUPle:PORT”.
SCPI Command Reference [:ROUTe]:FUNCtion [:ROUTe]:FUNCtion This command sets the channel configuration, which determines how you specify the channel_list or card_number in other commands. The query returns the present channel configuration. At *RST, this parameter is set to ACONfig. See “Channel Configuration Mode” on page 3-13. When configuration is changed by this command, all channels are opened (disconnected) and become same status as after :SYSTem:CPON ALL execution.
SCPI Command Reference [:ROUTe]:OPEN[:LIST] [:ROUTe]:OPEN[:LIST] This command disconnects the input ports from output ports as specified in channel_list. The query returns 0 or 1 for each channel specified by channel_list, in same order as specified by channel_list. For some modes (such as Single Route Mode, Couple Mode, Ground Mode, and Bias Mode), more complex disconnections may occur.
SCPI Command Reference [:ROUTe]:SYMBol:CHANnel [:ROUTe]:SYMBol:CHANnel In the GPIB local mode, the B2200 uses 01 to 48 (two digits numbers) to specify the output ports (channels) 1 to 48 respectively. This command specifies a symbol string and lets the B2200 use the specified string instead of the two digits number. The query returns the symbol string. Maximum value of the two digits number depends on the B2200 configuration.
SCPI Command Reference [:ROUTe]:SYMBol:PORT [:ROUTe]:SYMBol:PORT In the GPIB local mode, the B2200 uses 01 to 14 (two digits numbers) to specify the input ports 1 to 14 respectively. This command specifies a symbol string and lets the B2200 use the specified string instead of the two digits number. The query returns the symbol string. Reboot and *RST clear the symbol strings. After that, the initial symbol string (two digits numbers 01 to 14) will be set. :SYSTem:CPON does not clear the symbol strings.
SCPI Command Reference :SYSTem:BEEP :SYSTem:BEEP This command enables/disables the beeper. Syntax :SYSTem:BEEP state Parameter state Example Explanation ON or 1: enables the beeper OFF or 0: disables the beeper OUTPUT @Agb2200;":SYST:BEEP ON" :SYSTem:CCONfig? This query command is just to keep compatibility with the Agilent E5250A Low Leakage Switch Mainframe. This query command returns the card configuration information.
SCPI Command Reference :SYSTem:CDEScription? :SYSTem:CDEScription? This query command returns a description of the specified card. Syntax :SYSTem:CDEScription? card_number Parameter card_number Query response Explanation For Auto Config mode: 0 For Normal Config mode: 1, 2, 3, or 4 "card_description" <^END> If the designated card is not installed or initialize failed, this command returns "No Card".
SCPI Command Reference :SYSTem:CPON :SYSTem:CPON This command resets the specified card. Status after this command is shown below: Channel Configuration: Not changed. Connection Rule: Free Connection Sequence: Break Before Make Bias Mode: Off Bias Input Port: 10 Bias-enabled Channels: All channels (output ports) are bias-enabled. Couple Mode: Off Couple Input Port: Cleared. Ground Mode: Off Ground Input Port: 12 Ground-enabled Channels: Cleared. Ground-enabled Ports: Cleared.
SCPI Command Reference :SYSTem:CTYPe? :SYSTem:CTYPe? This query command returns the ID of the specified card. Syntax :SYSTem:CTYPe? card_number Parameter card_number Query response Explanation For Auto Config mode: 0 For Normal Config mode: 1, 2, 3, or 4 AGILENT TECHNOLOGIES,model,0,revision <^END> model = B2210A or B2211A revision = 1 or later version If designated card is not installed or initialize failed, this command returns NONE,NONE,0,0.
SCPI Command Reference :SYSTem:DISPlay:LED :SYSTem:DISPlay:LED This command enables/disables the front panel Light Emitting Diodes matrix when the B2200 is in the GPIB remote mode. The front panel LED matrix will be automatically set to ON by the mode transition from GPIB remote to GPIB local.
SCPI Command Reference :SYSTem:ERRor? :SYSTem:ERRor? This query command reads the error from the head of the error queue and removes that error from the queue. Syntax :SYSTem:ERRor? Query response err_no,"message" <^END> err_no is numeric response data, and message is string response data.
SCPI Command Reference :SYSTem:MEMOry:COMMent :SYSTem:MEMOry:COMMent This command memorizes the comment for the B2200 setup information specified by memory_number. The previous comment will be deleted. The query returns the comment for the specified setup. Syntax :SYSTem:MEMOry:COMMent memory_number,'comment' :SYSTem:MEMOry:COMMent? memory_number Parameter Explanation memory_number memory number: 1 to 8. comment Comment. Maximum 16 characters.
SCPI Command Reference :SYSTem:MEMOry:LOAD :SYSTem:MEMOry:LOAD This command restores the B2200 setup information specified by memory_number. It must be already saved by “:SYSTem:MEMOry:SAVE”. Syntax :SYSTem:MEMOry:LOAD memory_number Parameter memory_number Example Explanation memory number: 1 to 8. OUTPUT @Agb2200;":SYST:MEMO:SAVE 1" OUTPUT @Agb2200;":SYST:MEMO:LOAD 1" :SYSTem:MEMOry:SAVE This command saves the present setup information of the B2200 into the internal memory specified by memory_number.
SCPI Command Reference :SYSTem:PEN :SYSTem:PEN This command enables/disables the light pen. Syntax :SYSTem:PEN state Parameter state Example Explanation ON or 1: enables the light pen OFF or 0: disables the light pen OUTPUT @Agb2200;":SYST:PEN ON" :SYSTem:VERSion? This query command returns the SCPI version number for which the B2200 complies. Syntax :SYSTem:VERSion? Query response YYYY.V <^END> YYYY is the year (for example, 2004). V is the approved revision number for that year.
SCPI Command Reference Status Reporting Structure Status Reporting Structure This section describes the status reporting structure used in the B2200. These are IEEE 488.2 status structures that can be set and read by the SCPI Common Commands as described in “Common Commands” on page 5-4.
SCPI Command Reference Status Reporting Structure Figure 5-1 Status Reporting Structure of B2200 The above figure shows Service Request Generation. When a condition occurs that requires service, the instrument sets Request Service bit (RQS − bit6) of Status Byte, and sends a Service Request (SRQ) via GPIB bus to the controller.
SCPI Command Reference Status Byte Register Status Byte Register The B2200 Status Byte Register contains bits (ESB and MAV) for status summary messages from other registers. The status of these bits depends on the condition of the Standard Event Status Register and the Output Queue. If service request occurs, Bit6 (RQS) of Status Byte Register is set. See Figure 5-2 and Table 5-1 for the B2200 Status Byte Register.
SCPI Command Reference Status Byte Register In general, use serial polling (not *STB?) inside interrupt service routines. Use *STB? in other cases (not in interrupt service routine) when you want to know the value of Status Byte. Table 5-1 Status Byte Register of B2200 Bit Definition Explanation 0 Not Used. Always zero. 1 Not Used. Always zero. 2 Not Used. Always zero. 3 Not Used. Always zero. 4 Message Available (MAV) Queue Summary Message Indicates whether Output Queue is empty.
SCPI Command Reference Service Request Enable Register Service Request Enable Register The Service Request Enable Register is an 8-bit register that can be used by the programmer to select which summary messages in the Status Byte Register may cause service requests. See Figure 5-3.
SCPI Command Reference Standard Event Status Register Standard Event Status Register The Standard Event Status Register has specific events assigned to specific bits. See Figure 5-4 and Table 5-2.
SCPI Command Reference Standard Event Status Enable Register Table 5-2 Standard Event Status Register of B2200 Bit Definition Explanation 0 Operation Complete (OPC) This event bit has meaning only if a request to monitor is set by the *OPC command. See “*OPC” on page 5-8. This bit is set to 1 if there are no pending operations. 1 Not Used Always 0. 2 Query Error (QYE) • An attempt is being made to read data from the Output Queue when no data is present or pending.
SCPI Command Reference Output Queue Output Queue The Output Queue stores response messages until they are read. If an unread message exists, Bit4 (Message Available − MAV) of the Status Byte Register is set to 1. So, Bit4 is used to synchronize information exchange with the controller. See Figure 5-5. Figure 5-5 Output Queue of B2200 The Response Formatter places Data Byte Messages and END messages into the Output Queue in response to query commands.
6 VXI plug&play Driver
VXI plug&play Driver This chapter introduces the VXI plug&play driver available for Agilent B2200, and consists of the following sections: • “System Requirements” • “Installing VXIplug&play Driver” • “Driver Functions” 6-2 Agilent B2200 User’s Guide, Edition 2
VXI plug&play Driver System Requirements System Requirements The following system environments are required. • Operating System Microsoft Windows XP Professional, Windows 2000, Windows NT 4.0, or Windows 95. It must be supported by the application development environment. • Application Development Environment (programming environment) Microsoft Visual Basic, Microsoft Visual C++, Borland C++Builder, National Instruments LabWindows or LabVIEW, or Agilent VEE.
VXI plug&play Driver Installing VXIplug&play Driver Installing VXIplug&play Driver The installation flow is shown below. If you have already installed the GPIB interface card, VISA I/O library, and programming software on your PC, skip steps 1 through 5. 1. Install the GPIB interface card into your PC. See the interface card manual. Note the model number of the interface card, as you may need it to configure the interface (in step 3). 2. Install VISA I/O library.
VXI plug&play Driver Driver Functions Driver Functions Table 6-1 lists all the functions for the Agilent B2200. You will see a brief description of the functions in the table. For the description, syntax and parameters of the function, refer to the reference section following this table. The driver functions in the reference section will appear in the alphabetical order. Table 6-1 Category Agilent B2200 Driver Function Lists Function Description Miscellaneous agb220xa_init Initializes the B2200.
VXI plug&play Driver Driver Functions Category Function Description Ground Mode agb220xa_groundPort agb220xa_groundChanCard agb220xa_groundChanList agb220xa_unusedPort Selects the input ground port of the specified card. Ground-enables all output ports of the specified card. Ground-enables all output ports of the specified channel list. Ground-enables the specified input ports of the specified card. agb220xa_groundState Sets the ground mode ON or OFF for the specified card.
VXI plug&play Driver Driver Functions agb220xa_biasChanCard This function bias-enables or disables all the output ports of the specified card. Syntax ViStatus _VI_FUNC agb220xa_biasChanCard(ViSession vi, ViInt16 disable_enable, ViInt16 bias_cardno); Parameters vi Instrument handle returned from agb220xa_init( ). disable_enable Status of the card, bias enabled or bias disabled. 0 : sets bias enabled card. 1 : sets bias disabled card. bias_cardno Card number.
VXI plug&play Driver Driver Functions agb220xa_biasChanList_Q This function will query the instrument for the status, bias enabled or bias disabled, for the channels given in the list. The parameter “biaschan_list” is an array of integers with each integer representing one channel. The last number of the “biaschan_list” should be “0” (numeric zero) to identify the end of the list. The maximum number of channels that can be specified by the list is 100.
VXI plug&play Driver Driver Functions agb220xa_biasPort This function will select which input port is the bias port on the specified card. For each card, you can specify the same or different bias port. Syntax ViStatus _VI_FUNC agb220xa_biasPort(ViSession vi, ViInt16 bport_cardno, ViInt16 bias_port); Parameters vi Instrument handle returned from agb220xa_init( ). bport_cardno Card number.
VXI plug&play Driver Driver Functions agb220xa_close This function terminates the software connection to the instrument and deallocates system resources. It is generally a good programming habit to close the instrument handle when the program is done using the instrument. Syntax ViStatus _VI_FUNC agb220xa_close(ViSession vi); Parameters vi Instrument handle returned from agb220xa_init( ). agb220xa_closeCard_Q This function will query the card for the channels closed of the specified card.
VXI plug&play Driver Driver Functions agb220xa_closeList This function will connect the input ports to the output ports specified by the channel list. The parameter “closechan_list” is an array of integers with each integer representing one channel. The last number of the “closechan_list” should be “0” (numeric zero) to identify the end of the list. The maximum number of channels that can be specified by the list is 100.
VXI plug&play Driver Driver Functions agb220xa_closeList_Q This function will query the instrument for the channels closed given in the “closechan_list”. The parameter “closechan_list” is an array of integers with each integer representing one channel. The last number of the “closechan_list” should be “0” (numeric zero) to identify the end of the list. The maximum number of channels that can be specified by the list is 100.
VXI plug&play Driver Driver Functions agb220xa_cmdData_Q This function passes the cmd_str string to the instrument. This entry point will wait for a response which may be any data. You specify the cmd_str and size parameters, and get result[ ]. Syntax ViStatus _VI_FUNC agb220xa_cmdData_Q(ViSession vi, ViString cmd_str, ViInt32 size, ViChar_VI_FAR result[ ] ); Parameters vi Instrument handle returned from agb220xa_init( ). cmd_str Instrument command (cannot exceed 256 bytes in length).
VXI plug&play Driver Driver Functions agb220xa_cmdInt16Arr_Q This function passes the cmd_str string to the instrument. This command expects a response that is a definite arbitrary block of 16 bit integers. You specify the cmd_str and size parameters, and get result[ ] and count. Syntax ViStatus _VI_FUNC agb220xa_cmdInt16Arr_Q(ViSession vi, ViString cmd_str, ViInt32 size, ViInt16_VI_FAR result[ ], ViPInt32 count); Parameters vi Instrument handle returned from agb220xa_init( ).
VXI plug&play Driver Driver Functions agb220xa_cmdInt32Arr_Q This function passes the cmd_str string to the instrument. This command expects a response that is a definite arbitrary block of 32 bit integers. You specify the cmd_str and size parameters, and get result[ ] and count. Syntax ViStatus _VI_FUNC agb220xa_cmdInt32Arr_Q(ViSession vi, ViString cmd_str, ViInt32 size, ViInt32_VI_FAR result[ ], ViPInt32 count); Parameters vi Instrument handle returned from agb220xa_init( ).
VXI plug&play Driver Driver Functions agb220xa_cmdReal This function passes the cmd_str string to the instrument. This entry point passes the string in cmd_str followed by a space and then the real in value. Note that either an Real32 or 64 can be passed as the Real32 will be promoted. Syntax ViStatus _VI_FUNC agb220xa_cmdReal(ViSession vi, ViString cmd_str, ViReal64 value); Parameters vi Instrument handle returned from agb220xa_init( ). cmd_str Instrument command (cannot exceed 256 bytes in length).
VXI plug&play Driver Driver Functions agb220xa_cmdReal64_Q This function passes the cmd_str string to the instrument. This command expects a response that can be returned as a 64 bit real. Syntax ViStatus _VI_FUNC agb220xa_cmdReal64_Q(ViSession vi, ViString cmd_str, ViPReal64 result); Parameters vi Instrument handle returned from agb220xa_init( ). cmd_str Instrument command (cannot exceed 256 bytes in length). result Response from instrument.
VXI plug&play Driver Driver Functions agb220xa_compenC This function compensates capacitance/conductance data measured by the Agilent 4284A LCR meter, and returns compensation results. Before this function is executed, a compensation data file must be specified by using the agb220xa_selectCompenFile function. The file must contain the appropriate compensation coefficients for your measurement environment.
VXI plug&play Driver Driver Functions agb220xa_couplePort This function sets the couple ports which are used for making kelvin connections on the specified card. The specified input port number will be coupled with the next input port and two output ports. For each card, you may setup the same or different couple ports. This command overwrites the previous couple port setting for the card. The couple mode is controlled by the agb220xa_coupleState function.
VXI plug&play Driver Driver Functions port13 Couple port by the input ports 13 and 14. 0 (disable) or 1 (enable). agb220xa_coupleState This function controls the couple mode for the specified card. Syntax ViStatus _VI_FUNC agb220xa_coupleState(ViSession vi, ViInt16 cstate_cardno, ViInt16 couple_state); Parameters vi Instrument handle returned from agb220xa_init( ). cstate_cardno Card number.
VXI plug&play Driver Driver Functions Parameters vi Instrument handle returned from agb220xa_init( ). agb220xa_error_message This function translates the error return value from an instrument driver function to a readable string. Syntax ViStatus _VI_FUNC agb220xa_error_message(ViSession vi, ViStatus error_number, ViChar_VI_FAR message[ ] ); Parameters vi Instrument handle returned from agb220xa_init( ). error_number Error return value from the driver function. message[ ] Error message string.
VXI plug&play Driver Driver Functions agb220xa_errorQueryDetect This function enables or disables automatic instrument error checking. If automatic error checking is enabled then the driver will query the instrument for an error at the end of each function call. Syntax ViStatus _VI_FUNC agb220xa_errorQueryDetect(ViSession vi, ViBoolean errorQueryDetect); Parameters vi Instrument handle returned from agb220xa_init( ). errorQueryDetect Error checking enable (VI_TRUE) or disable (VI_FALSE).
VXI plug&play Driver Driver Functions agb220xa_esr_Q This function returns the contents of the ESR register. The driver returns the equivalent messages (see Parameters). Syntax ViStatus _VI_FUNC agb220xa_esr_Q(ViSession vi, ViChar_VI_FAR errstr[ ] ); Parameters vi Instrument handle returned from agb220xa_init( ). errstr[ ] Response from instrument.
VXI plug&play Driver Driver Functions agb220xa_groundChanCard This function ground-enables or disables all the output ports of the specified card. Syntax ViStatus _VI_FUNC agb220xa_groundChanCard(ViSession vi, ViInt16 disable_enable, ViInt16 gnd_cardno); Parameters vi Instrument handle returned from agb220xa_init( ). disable_enable Status of the card, ground enabled or ground disabled. 0 : sets ground enabled card. 1 : sets ground disabled card. gnd_cardno Card number.
VXI plug&play Driver Driver Functions agb220xa_groundChanList_Q This function will query the instrument for the status, ground enabled or disabled, for the channels given in the list. The parameter “gndchan_list” is an array of integers with each integer representing one channel. The last number of the “gndchan_list” should be “0” (numeric zero) to identify the end of the list. The maximum number of channels that can be specified by the list is 100.
VXI plug&play Driver Driver Functions agb220xa_groundPort This function will select which input port is the ground port on the specified card. For each card, you can specify the same or different ground port. Syntax ViStatus _VI_FUNC agb220xa_groundPort(ViSession vi, ViInt16 gport_cardno, ViInt16 gnd_port); Parameters vi Instrument handle returned from agb220xa_init( ). gport_cardno Card number.
VXI plug&play Driver Driver Functions agb220xa_init This function initializes the software connection to the instrument and optionally verifies that instrument is in the system. In addition, it may perform any necessary actions to place the instrument in its reset state. If the agb220xa_init function encounters an error, then the value of the vi output parameter will be VI_NULL.
VXI plug&play Driver Driver Functions agb220xa_openCard This function will disconnect all input ports from all output ports for the specified card. If bias mode is ON, the input bias port is connected to all bias enabled output ports. If ground mode is ON, the input ground port is connected to all ground enabled input ports and output ports. Syntax ViStatus _VI_FUNC agb220xa_openCard(ViSession vi, ViInt16 open_cardno); Parameters vi Instrument handle returned from agb220xa_init( ).
VXI plug&play Driver Driver Functions agb220xa_openList_Q This function will query the instrument for the channels open given in the “openchan_list”. The parameter “openchan_list” is an array of integers with each integer representing one channel. The last number of the “openchan_list” should be “0” (numeric zero) to identify the end of the list. The maximum number of channels that can be specified by the list is 100.
VXI plug&play Driver Driver Functions agb220xa_reset This function places the instrument in a default state. Before issuing this function, it may be necessary to send a device clear to ensure that the instrument can execute a reset. A device clear can be issued by invoking agb220xa_dcl function. Syntax ViStatus _VI_FUNC agb220xa_reset(ViSession vi); Parameters vi Instrument handle returned from agb220xa_init( ).
VXI plug&play Driver Driver Functions agb220xa_self_test This function causes the instrument to perform a self-test and returns the result of that self-test. This is used to verify that an instrument is operating properly. A failure may indicate a potential hardware problem. Syntax ViStatus _VI_FUNC agb220xa_self_test(ViSession vi, ViPInt16 test_result, ViChar_VI_FAR test_message[ ] ); Parameters vi Instrument handle returned from agb220xa_init( ). test_result Numeric result from self-test operation.
VXI plug&play Driver Driver Functions agb220xa_testExec_Q This function performs the diagnostics and returns the test result. For details of each test, see “Selftest Menu” on page 3-34. Syntax ViStatus _VI_FUNC agb220xa_testExec_Q(ViSession vi, ViInt16 framecard_exec, ViPInt16 exec_result); Parameters vi Instrument handle returned from agb220xa_init( ). framecard_exec Test item to perform. 1 to 10. See below.
VXI plug&play Driver Driver Functions agb220xa_timeOut_Q This function returns the timeout value for driver I/O transactions in milliseconds. Syntax ViStatus_VI_FUNC agb220xa_timeOut_Q(ViSession vi, ViPInt32 pTimeOut); Parameters vi Instrument handle returned from agb220xa_init( ). pTimeOut Minimum timeout period that the driver can be set to, in milliseconds. agb220xa_unusedPort This function ground-enables the specified input ports of the specified card.
VXI plug&play Driver Driver Functions 6-34 Agilent B2200 User’s Guide, Edition 2
7 Error Messages
Error Messages This chapter lists and describes the error messages for Agilent B2200. An error message consists of an error number and message. There are two types of error messages: • Standard SCPI Error Messages Negative error numbers (Command Error, Execution Error, Device-Dependent Error, and Query Error) are standard SCPI errors. • B2200 Specific Error Messages Positive error numbers are the B2200 specific errors.
Error Messages Standard SCPI Error Messages Standard SCPI Error Messages Standard SCPI error messages have negative error numbers. The following are the standard SCPI error messages for the B2200: Command Error If syntax of SCPI command is not valid, a -1XX error occurs. The error number and message are placed in the error queue, and bit5 of the Standard Event Status Register is set. A SCPI command consists of a command header and zero or more parameters.
Error Messages Standard SCPI Error Messages Error Number -103 Error Message and Description Invalid separator An illegal character was received when a separator was expected; for example, the semicolon was omitted between multiple commands in a program message. -104 Data type error An improper data type was received; for example, numeric data was expected but string data was received. -105 GET not allowed A group execute trigger was received within a program message.
Error Messages Standard SCPI Error Messages Error Number -120 Error Message and Description Numeric data error An error was detected in a numeric parameter (including the non-decimal numeric types). This error message is reported when the B2200 cannot determine the more specific errors -121 through -128. -121 Invalid character in number An invalid character for the parameter was received; for example, an alphacharacter was received when the parameter type was decimal numeric.
Error Messages Standard SCPI Error Messages Error Number -148 Error Message and Description Character data not allowed A character parameter is not allowed for this position. -150 String data error An error was detected in a string parameter. This error is reported if the B2200 cannot determine a more specific error -151 and -158. -151 Invalid string data An invalid string parameter data was received; for example, an END message was received before the terminal quote character.
Error Messages Standard SCPI Error Messages Execution Error If syntax of a SCPI command header and parameter is valid, but the command cannot be executed due to some condition of the B2200, a -2XX error occurs. The error number and message are placed in the error queue, and bit4 of the Standard Event Status Register is set. Error Number -200 Error Message and Description Execution error Generic execution error that cannot be determined more specifically.
Error Messages Standard SCPI Error Messages Device-Dependent Errors -3XX errors indicate that an B2200 operation did not properly complete, possibly due to an abnormal hardware or firmware condition. These negative codes are SCPI defined. For the device-dependent positive error codes, see “B2200 Specific Error Messages” on page 7-10. The positive codes are not SCPI defined. For these errors, an error number and message are placed in the error queue, and bit3 of the Standard Event Status Register is set.
Error Messages Standard SCPI Error Messages Query Errors If the output queue control of the B2200 detects one of following problems, a -4XX error occurs:. • An attempt was made to read data from the output queue when no output data is present or pending. • Data in the output queue has been lost. If this type of error occurs, the error number and message are placed in the error queue, and bit2 of the Standard Event Status Register is set.
Error Messages B2200 Specific Error Messages B2200 Specific Error Messages These are the B2200-specific errors that are not defined by SCPI. These errors indicate that an B2200 operation did not properly complete due to card, channel, port, or mode errors. For the SCPI defined device-dependent codes, see “Device-Dependent Errors” on page 7-8. For these errors, an error number and message are placed in the error queue, and bit3 of the Standard Event Status Register is set.
Error Messages B2200 Specific Error Messages B2200 Channel Related Errors Error Number 2000 Error Message and Description Invalid card number Wrong card number is specified in card number or channel list parameter. Make sure card is properly installed in the correct B2200 slot. 2001 Invalid channel number Wrong channel number is specified in the channel list. Confirm the channel number, the card configuration, and the configuration mode of the B2200.
Error Messages B2200 Specific Error Messages B2200 Card/Mode/Port Related Errors Error Number 3000 Error Message and Description Card0 initialization fail The B2200 may be defective. Contact your nearest Agilent Technologies service center. 3001 Card1 initialization fail The B2200 or card installed in slot 1 of the B2200 may be defective. 3002 Card2 initialization fail The B2200 or card installed in slot 2 of the B2200 may be defective.
Error Messages B2200 Specific Error Messages Error Number 3017 Error Message and Description Too many relays closed. Max 52 relays/card. Too many relays have been closed. To close new relays, open some relays. Maximum 52 relays can be closed for each module. 3018 Can't change to ACONfig mode. Check card config. The present card configuration of the B2200 does not allow the auto configuration mode. Change the module configuration.
Error Messages B2200 Specific Error Messages Error Number 3026 Error Message and Description Cannot use same port for Unused and Couple The couple mode and the ground mode cannot be used in parallel when a couple port and the ground enabled input port (unused port) have been assigned to the same input port. 3027 Cannot use Unused Port during Auto Ground Mode ON The ground enabled input port (unused port) must be opened during the ground mode is ON.
