Agilent B2200A Femto Leakage Switch Mainframe Agilent B2201A 14ch Low Leakage Switch Mainframe User’s Guide Agilent Technologies
Notices © Agilent Technologies, Inc. 2004, 2005, 2009, 2011 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. Manual Part Number B2200-90000 Edition Edition 1, October 2004 Edition 2, July 2005 Edition 3, July 2009 Edition 4, August 2011 Agilent Technologies, Inc.
DECLARATION OF CONFORMITY According to EN ISO/IEC 17050-1:2004 Manufacturer’s Name: Manufacturer’s Address: Agilent Technologies Singapore (International) Pte. Ltd. No.
• Herstellerbescheinigung GERÄUSCHEMISSION Lpa < 70 dB am Arbeitsplatz normaler Betrieb nach DIN 45635 T. 19 • Manufacturer’s Declaration ACOUSTIC NOISE EMISSION Lpa < 70dB operator position normal operation per ISO 7779 NOTE This ISM device complies with Canadian ICES-001. Cet appareil ISM est conforme à la norme NMB-001 du Canada. South Korean Class A EMC declaration This equipment is Class A suitable for professional use and is for use in electromagnetic environments outside of the home.
This product complies with the WEEE Directive (2002/96/EC) marking requirements. The affixed label indicates that you must not discard this electrical/ electronic product in domestic household waste. Product Category: With reference to the equipment types in the WEEE Directive Annex I, this product is classed as a “Monitoring and Control instrumentation” product. Do not dispose in domestic household waste. To return unwanted products, contact your local Agilent office, or see www.agilent.
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.
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. Instructions contained in the warnings must be followed.
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11 Output Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11 Connector Plates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents To Set GPIB Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 To Set Remote Display Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 To Return to Local Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11 Switch Control Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Using Couple Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14 Saving Input/Output Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16 Defining Comment for Internal Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18 Capacitance Compensation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents [:ROUTe]:AGND:CHANnel:DISable[:LIST] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24 [:ROUTe]:AGND:CHANnel:ENABle:CARD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25 [:ROUTe]:AGND:CHANnel:ENABle[:LIST] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25 [:ROUTe]:AGND:PORT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26 [:ROUTe]:AGND[:STATe] . . . . . . . . . . . . . . . . . . . . . . . .
Contents :SYSTem:ERRor? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-46 :SYSTem:KLC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-46 :SYSTem:MEMOry:COMMent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-47 :SYSTem:MEMOry:DELete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-47 :SYSTem:MEMOry:LOAD. . .
Contents agb220xa_cmdData_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11 agb220xa_cmdInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12 agb220xa_cmdInt16Arr_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12 agb220xa_cmdInt16_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12 agb220xa_cmdInt32Arr_Q . .
Contents agb220xa_readStatusByte_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-25 agb220xa_reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26 agb220xa_revision_query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26 agb220xa_selectCompenFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26 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 4
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 4 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 4 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 4 1-9
Introduction Specifications Specifications This section lists specifications and supplemental information for the Agilent B2200 series. • “General Specifications” • “Switch Modules” • “Supplemental Characteristics for B2200A/B2210A” • “Supplemental Characteristics for B2201A/B2211A” The specifications are the performance standards or limits against which these units have been tested.
Introduction Specifications General Specifications Temperature range Operating: 5 °C to 35 °C Storage: -20 °C to 70 °C Humidity range Operating: 5 % to 70 % R.H.
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 I-V port 1.0 1.0 AUX port 0.5 0.
Introduction Specifications Supplemental Characteristics for B2200A/B2210A Offset current 1 IM noise (RMS) 10 fA, I-V port 2 Channel crosstalk capacitance 0.6 fA, I-V port < 1 pF per channel, I-V port < 3 pF per channel, AUX port Offset voltage < 50 μV, I-V port < 80 μV, AUX port Settling time 3 2.0 seconds at 50 fA Bandwidth (at -3dB) 30 MHz, AUX port Guard capacitance 4 < 145 pF, I-V port 5 Additional C measurement error < ± 1 % + 0.2 pF, AUX port 1.
Introduction Specifications Supplemental Characteristics for B2201A/B2211A Offset current 1 IM noise (RMS) 100 fA, I-V port 2 Channel crosstalk capacitance 5 fA, I-V port < 0.5 pF per channel, I-V port < 3 pF per channel, AUX port Offset voltage < 80 μV, I-V port < 100 μV, AUX port Settling time 3 2.0 seconds at 300 fA Bandwidth (at -3dB) 30 MHz, AUX port Guard capacitance 4 < 145 pF, I-V port 5 Additional C measurement error < ± 1 % + 0.2 pF, AUX port 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. • Software CD, 1 ea. Stores the Agilent B2200 VXIplug&play driver. • NOTE Moisture-proof and dehumidifying packing kit, 1 set For the latest system requirements of the VXIplug&play driver, go to www.agilent.com and type in B2200A in the Search field at the top of the page.
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 4
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 • • • • • • • • • • Plug: BS 1363/A, 250 V, 10 A PN: 8120-4420 • Plug: NEMA 6-15P, 250 V, 10 A PN: 8120-3996, 8120-0698 • Plug: JIS C 8303, 125 V, 12 A PN: 8121-0743 • Plug: GB 1002 figure 3 , 250 V, 10 A PN: 8120-8376 • Plug: CNS 10917-2, 125 V, 10 A PN: 8120-6825, 8121-1635 • • • • • • 2-4 Plug: AS 3112, 250 V, 10 A PN: 8120-4419 • Plug: SEV 1011, 250 V, 10 A PN: 8120-2104 • Plug: Israel SI 32, 250 V, 10 A PN: 8120-5182 • Plug: SANS 164-1, 250 V, 10 A
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-1) 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-2. Table 2-1 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-2.
Installation Output Connections Table 2-3 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-4 Recommended Parts Description Interlock Connector (6 pin, female) 1252-1419 Switch 3101-0302 or 3101-3241 LED (VF @ 2.1 V @ IF = 10 mA) 1450-0641 Wire (24 AWG, 600 V, 150 °C) 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-5 Agilent Part No. Kelvin Triaxial Connector (in mm) 14 11 11 14 2.8 10.
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-6 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-7 lists the guard capacitance for each element of the Agilent B2200’s measurement environment.
Installation Measurement Cable Length Table 2-7 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 4
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 NOTE Connection rule cannot be specified for the input ground port, which can always be connected to multiple output ports. Connection sequence (to connect input ground port to output ports) is always Break-Before-Make. Ground mode cannot be set to ON when the bias mode is ON. The input ground port and a ground enabled input port cannot be assigned to the same input port.
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” To execute the example programs The following hardware and software must be installed in the computer (instrument controller).
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 Ivi.visa.interop Module Module1 Sub Main() Dim B220x As IResourceManager Dim B2200 As IMessage B220x = New ResourceManager B2200 = B220x.Open("GPIB0::22::INSTR") Dim channels As String = "(@10101,10202,10303,10404)" B2200.WriteString("*RST") B2200.WriteString(":ROUT:FUNC NCON") B2200.WriteString(":ROUT:CONN:RULE ALL,SROU") B2200.WriteString(":ROUT:CONN:SEQ ALL,BBM") 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 Ivi.visa.interop Module Module1 Sub Main() Dim B220x As IResourceManager Dim B2200 As IMessage B220x = New ResourceManager B2200 = B220x.Open("GPIB0::22::INSTR") Dim channels As String = "(@101,202,303,404)" B2200.WriteString("*RST") B2200.WriteString(":ROUT:FUNC ACON") B2200.WriteString(":ROUT:CONN:RULE ALL,SROU") B2200.WriteString(":ROUT:CONN:SEQ ALL,BBM") B2200.WriteString(":ROUT:BIAS:PORT ALL,10") 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 Ivi.visa.interop Module Module1 Sub Main() Dim B220x As IResourceManager Dim B2200 As IMessage B220x = New ResourceManager B2200 = B220x.Open("GPIB0::22::INSTR") Dim channels As String = "(@101,202,303,404)" B2200.WriteString("*RST") B2200.WriteString(":ROUT:FUNC ACON") B2200.WriteString(":ROUT:CONN:RULE ALL,SROU") B2200.WriteString(":ROUT:CONN:SEQ ALL,BBM") B2200.WriteString(":ROUT:AGND:PORT ALL,12") 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 Ivi.visa.interop Module Module1 Sub Main() Dim B220x As IResourceManager Dim B2200 As IMessage B220x = New ResourceManager B2200 = B220x.Open("GPIB0::22::INSTR") Dim channels As String = "(@101,202,303,505)" B2200.WriteString("*RST") B2200.WriteString(":ROUT:FUNC ACON") B2200.WriteString(":ROUT:CONN:RULE ALL,SROU") B2200.WriteString(":ROUT:CONN:SEQ ALL,BBM") B2200.WriteString(":ROUT:COUP:PORT ALL,’3,5’") 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 Ivi.visa.interop '1 Module Module1 Sub Main() Dim B220x As IResourceManager Dim B2200 As IMessage B220x = New ResourceManager B2200 = B220x.Open("GPIB0::22::INSTR") B2200.WriteString("*RST") B2200.WriteString(":ROUT:FUNC ACON") Console.WriteLine("Starts labeling." & Chr(10)) B2200.WriteString(":SYST:DISP:STR ’Updating memory 1 data.’") B2200.WriteString(":ROUT:SYMB:PORT 1,’SMU1 ’") '12 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 Ivi.visa.interop '1 Module Module1 Sub Main() Dim B220x As IResourceManager Dim B2200 As IMessage B220x = New ResourceManager B2200 = B220x.Open("GPIB0::22::INSTR") B2200.WriteString("*RST") B2200.WriteString(":ROUT:FUNC ACON") Console.WriteLine("Starts labeling." & Chr(10)) B2200.WriteString(":SYST:DISP:STR ’Updating memory comment.’") B2200.WriteString(":SYST:MEMO:COMM 1,’1-1,2-2,3-3,5-15’") '12 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 Agilent 16494F CMU cable or Agilent 16048 test leads (≤ 4 m) 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 #include #include #include #include #include Capacitance Compensation Program Example "stdafx.h" "agb220xa.h" ViStatus main() { ViStatus ret; ViSession vi; ViChar err_msg[256]; ret = agb220xa_init("GPIB0::22::INSTR", VI_TRUE, VI_TRUE, &vi); if ( ( ret < VI_SUCCESS ) || ( vi == VI_NULL ) ) { printf("Initialization failure.\n Status code: %d.
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-50. 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-50.
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:FRAMe:CLEar 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:STATe? Syntax :DIAGnostic:TEST:FRAMe[:EXECute]? CONTroller | FPANel | LED | PEN | BEEPer Parameter Query response Explanation CONTroller Controller test FPANel Front panel interface test LED LED matrix test PEN Light pen test BEEPer Beeper test test_result <^END> 1: fail 0: pass Example OUTPUT @Agb2200;":DIAG:TEST:FRAM? CONT" :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:CARD Example OUTPUT @Agb2200;":DIAG:TEST:FRAM:STAT? CONT" ENTER @Agb2200;A [:ROUTe]:AGND:CHANnel:DISable:CARD This command ground-disables the all output ports (channels) for the specified card. 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]”.
SCPI Command Reference [:ROUTe]:AGND:CHANnel:ENABle:CARD Example OUTPUT @Agb2200;":ROUT:AGND:CHAN:DIS (@10101)" OUTPUT @Agb2200;":ROUT:AGND:CHAN:DIS? (@10101,10102,10201)" ENTER @Agb2200;A$ This example ground-disables the output port 1 on the card 1. In this example, A$ will be 1,0,1. [:ROUTe]:AGND:CHANnel:ENABle:CARD This command ground-enables the all output ports (channels) for the specified card.
SCPI Command Reference [:ROUTe]:AGND:PORT Input port is always the input Ground Port. So, the input ports in channel_list are ignored. However, you cannot abbreviate the input port number. Query response enable_status{, enable_status} <^END> 1: ground enabled 0: ground disabled Example OUTPUT @Agb2200;":ROUT:AGND:CHAN:ENAB (@10101)" OUTPUT @Agb2200;":ROUT:AGND:CHAN:ENAB? (@10101,10102,10201)" ENTER @Agb2200;A$ This example ground-enables the output port 1 on the card 1.
SCPI Command Reference [:ROUTe]:AGND[:STATe] Example OUTPUT @Agb2200;":ROUT:AGND:PORT 0,13" OUTPUT @Agb2200;":ROUT:AGND:PORT? 0" ENTER @Agb2200;A In this example, A will be 13. [: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.
SCPI Command Reference [:ROUTe]:AGND:UNUSED Example OUTPUT @Agb2200;":ROUT:AGND:STAT 0,ON" OUTPUT @Agb2200;":ROUT:AGND:STAT? 0" ENTER @Agb2200;A In this example, A will be 1. [: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.
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]:COUPle:PORT The connection sequence is used only for cards that have been set to SROUte connection rule. Also see “[:ROUTe]:CONNection:RULE”. Syntax [:ROUTe]:CONNection:SEQuence card_number,sequence [:ROUTe]:CONNection:SEQuence? card_number Parameter Explanation card_number For Auto Config mode: 0 or ALL For Normal Config mode: 1, 2, 3, 4, or ALL ALL is not available for query.
SCPI Command Reference [:ROUTe]:COUPle:PORT:DETect At *RST, no input ports are coupled. Syntax [:ROUTe]:COUPle:PORT card_number,'couple_port' [:ROUTe]:COUPle:PORT? card_number Parameter Explanation card_number For Auto Config mode: 0 or ALL For Normal Config mode: 1, 2, 3, 4, or ALL ALL is not available for query. couple_port One or more input port numbers: 1, 3, 5, 7, 9, 11 or 13. Enclose by single quotation marks. Separate multiple input port numbers by comma.
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:PORT Syntax [:ROUTe]:SYMBol:CHANnel card_number,channel_number,'string' [:ROUTe]:SYMBol:CHANnel? card_number,channel_number Parameter Explanation card_number For Auto Config mode: 0 or ALL For Normal Config mode: 1, 2, 3, 4, or ALL ALL is not available for query. channel_number Output port number: 1 to 48 for Auto, 1 to 12 for Normal. string Symbol string set to the specified output port (channel). Maximum 6 characters.
SCPI Command Reference :SYSTem:BEEP [:ROUTe]:SYMBol:PORT? port_number Parameter Explanation port_number Input port number: 1 to 14. symbol_string Symbol string set to the specified input port. Maximum 6 characters. Numeric characters, alphabetic characters; upper case and lower case, space, and the following symbols are available. ! "#$%&’()*+,-.
SCPI Command Reference :SYSTem:CDEScription? Syntax :SYSTem:CCONfig? card_number Parameter card_number Query response Explanation card number: 1, 2, 3, or 4 card_configuration <^END> Always returns #10. Example OUTPUT @Agb2200;":SYST:CCON? 1" ENTER @Agb2200;A$ PRINT "Card configuration = ";A$ :SYSTem:CDEScription? This query command returns a description of the specified card.
SCPI Command Reference :SYSTem:CPON For B2201A: • In the Auto Config mode, "card_description" response is one of following: • "B2211A 14x12 Low Leakage Switch Module" • "B2211A 14x24 Low Leakage Switch Module" • "B2211A 14x36 Low Leakage Switch Module" • "B2211A 14x48 Low Leakage Switch Module" • In the Normal Config mode: "B2211A 14x12 Low Leakage Switch Module" Example OUTPUT @Agb2200;":SYST:CDES? 1" ENTER @Agb2200;A$ :SYSTem:CPON This command resets the specified card.
SCPI Command Reference :SYSTem:CTYPe? For the device reset state, see *RST. Syntax :SYSTem:CPON 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;":SYST:CPON ALL" :SYSTem:CTYPe? This query command returns the ID of the specified card.
SCPI Command Reference :SYSTem:DISPlay:LED Syntax :SYSTem:DISPlay:LCD state Parameter state Explanation ON or 1: enables the LCD OFF or 0: disables the LCD (initial setting) Even though state is OFF, some status indicators on the LCD will be effective. Example OUTPUT @Agb2200;":SYST:DISP:LCD 1" :SYSTem:DISPlay:LED This command enables/disables the front panel Light Emitting Diodes matrix when the B2200 is in the GPIB remote mode.
SCPI Command Reference :SYSTem:ERRor? Syntax :SYSTem:DISPlay:STRing 'string' Parameter Explanation string String to be displayed on the front panel LCD. Maximum 38 characters. Numeric characters, alphabetic characters; upper case and lower case, space, and the following symbols are available. ! "#$%&’()*+,-./>?:~;<=>?@[\]‘{|}^_ Example OUTPUT @Agb2200;":SYST:DISP:STR 'E:SMU1,B:SMU2,C:SMU3'" This example displays E:SMU1,B:SMU2,C:SMU3 on the front panel LCD.
SCPI Command Reference :SYSTem:MEMOry:COMMent Example OUTPUT @Agb2200;":SYST:KLC ON" :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.
SCPI Command Reference Output Queue 5-58 Agilent B2200 User’s Guide, Edition 4
6 VXIplug&play Driver
VXIplug&play Driver This chapter introduces the VXIplug&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 4
VXIplug&play Driver System Requirements System Requirements The following system environments are required. • Operating System Microsoft Windows 7 Professional or Windows XP Professional. 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.
VXIplug&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 4. 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.
VXIplug&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.
VXIplug&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.
VXIplug&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.
VXIplug&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.
VXIplug&play Driver Driver Functions bport_cardno Card number. 1 (card 1), 2 (card 2), 3 (card 3), 4 (card 4), or 5 (all card) in the normal configuration mode, or 0 (all card in the auto configuration mode). For the configuration mode, see agb220xa_func. bias_port Input port number to be set to the bias port. 1 to 14 (input port 1 to input port 14). 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.
VXIplug&play Driver Driver Functions agb220xa_closeCard_Q This function will query the card for the channels closed of the specified card. The parameter “closechan_list” contains the channel numbers returned by the instrument. This will be an array of integers terminated by “zero” to identify the end of the list. Array of enough length should be passed to the function.
VXIplug&play Driver Driver Functions 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. The “close_status” parameter is an array of integers containing the return values of the query. The “close_status” array returned will correspond one to one with “closechan_list” parameter.
VXIplug&play Driver Driver Functions cmd_str Instrument command (cannot exceed 256 bytes in length). size Length of result in bytes. 2 to 32767. result[ ] Response from instrument. agb220xa_cmdInt 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 integer in value. Note that either an Int16 or 32 can be passed as the Int16 will be promoted.
VXIplug&play Driver Driver Functions Syntax ViStatus _VI_FUNC agb220xa_cmdInt16_Q(ViSession vi, ViString cmd_str, ViPInt16 result); Parameters vi Instrument handle returned from agb220xa_init( ). cmd_str Instrument command (cannot exceed 256 bytes in length). result Response from instrument. 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.
VXIplug&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).
VXIplug&play Driver Driver Functions cmd_str Instrument command (cannot exceed 256 bytes in length). result Response from instrument. agb220xa_cmdString_Q This function passes the cmd_str string to the instrument. This entry point will wait for a response which must be a string (character data). You specify the cmd_str and size parameters, and get result[ ].
VXIplug&play Driver Driver Functions agb220xa_connRuleSeq The function sets connection rule and connection sequence for the specified card. Syntax ViStatus _VI_FUNC agb220xa_connRuleSeq(ViSession vi, ViInt16 cardno_ruleseq, ViInt16 rule, ViInt16 sequence); Parameters vi Instrument handle returned from agb220xa_init( ). cardno_ruleseq Card number. 1 (card 1), 2 (card 2), 3 (card 3), 4 (card 4), or 5 (all card) in the normal configuration mode, or 0 (all card in the auto configuration mode).
VXIplug&play Driver Driver Functions cport_cardno Card number. 1 (card 1), 2 (card 2), 3 (card 3), 4 (card 4), or 5 (all card) in the normal configuration mode, or 0 (all card in the auto configuration mode). For the configuration mode, see agb220xa_func. port1 Couple port by the input ports 1 and 2. 0 (disable) or 1 (enable). port3 Couple port by the input ports 3 and 4. 0 (disable) or 1 (enable). port5 Couple port by the input ports 5 and 6. 0 (disable) or 1 (enable).
VXIplug&play Driver Driver Functions A device clear will abort the present operation and enable the instrument to accept a new command or query. This is particularly useful in situations where it is not possible to determine the instrument state. In this case, it is customary to send a device clear before issuing a new instrument driver function. The device clear ensures that the instrument will be able to begin processing the new commands.
VXIplug&play Driver Driver Functions Instrument errors may occur when you places the instrument in a bad state such as sending an invalid sequence of coupled commands. Instrument errors can be detected by polling. Automatic polling can be accomplished by using the agb220xa_errorQueryDetect function. Syntax ViStatus _VI_FUNC agb220xa_error_query(ViSession vi, ViPInt32 error_number, ViChar_VI_FAR error_message[ ] ); Parameters vi Instrument handle returned from agb220xa_init( ).
VXIplug&play Driver Driver Functions 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.
VXIplug&play Driver Driver Functions 1 : sets ground disabled card. gnd_cardno Card number. 1 (card 1), 2 (card 2), 3 (card 3), 4 (card 4), or 5 (all card) in the normal configuration mode, or 0 (all card in the auto configuration mode). For the configuration mode, see agb220xa_func. agb220xa_groundChanList This function ground-enables or disables all the output ports specified by the gndchan_list. The parameter “gndchan_list” is an array of integers with each integer representing one channel.
VXIplug&play Driver Driver Functions Syntax ViStatus _VI_FUNC agb220xa_groundChanList_Q(ViSession vi, ViInt16 gnd_disen, ViInt32_VI_FAR gndchan_list[ ], ViInt32_VI_FAR gnd_status[ ] ); Parameters vi Instrument handle returned from agb220xa_init( ). gnd_disen Query type. 0 : checks if the port is the ground enabled. 1 : checks if the port is the ground disabled. gndchan_list[ ] Channel numbers to check the status. 5 digits integer. ABCDE.
VXIplug&play Driver Driver Functions gnd_port Input port number to be set to the ground port. 1 to 14 (input port 1 to input port 14). agb220xa_groundState This function controls the ground mode for the specified card. When ground mode is ON, the input ground port is connected to all ground enabled input ports and output ports that are not connected to any other input ports. Ground disabled output ports are never connected to the input ground port when ground mode is ON.
VXIplug&play Driver Driver Functions vi Instrument handle. This is VI_NULL if an error occurred during the initialization. agb220xa_opc_Q This function does the *OPC? common command. Syntax ViStatus _VI_FUNC agb220xa_opc_Q(ViSession vi, ViPBoolean result); Parameters vi Instrument handle returned from agb220xa_init( ). result VI_TRUE (Operation complete), or VI_FALSE (Operation is pending). agb220xa_openCard This function will disconnect all input ports from all output ports for the specified card.
VXIplug&play Driver Driver Functions Syntax ViStatus _VI_FUNC agb220xa_openList(ViSession vi, ViInt32_VI_FAR openchan_list[ ] ); Parameters vi Instrument handle returned from agb220xa_init( ). openchan_list[ ] Channel numbers to disconnect. 5 digits integer. ABCDE. where A: card number, BC: input port number, DE: output port number. Top zero(s) can be ignored. For example, if A=0, BC=01, and DE=01, channel number should be 101 instead of 00101.
VXIplug&play Driver Driver Functions Syntax ViStatus _VI_FUNC agb220xa_readStatusByte_Q(ViSession vi, ViPInt16 statusByte); Parameters vi Instrument handle returned from agb220xa_init( ). statusByte The contents of the status byte are returned in this parameter. 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.
VXIplug&play Driver Driver Functions file_name Compensation data file name. Use absolute path. If the value is NULL string, the default data is used. 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.
VXIplug&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.
VXIplug&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.
VXIplug&play Driver Driver Functions 6-30 Agilent B2200 User’s Guide, Edition 4
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.
