VXIplug&play Driver User’s Guide
Agilent 4155C Semiconductor Parameter Analyzer
Agilent 4156C Precision Semiconductor Parameter Analyzer
Agilent Part No. 04156-90080
Printed in Japan January 2001
Edition 1
Legal Notice
The information contained in this document is subject to change without notice.
Copyright © 2001 Agilent Technologies
This document contains information which is protected by copyright. All rights are
reserved. Reproduction, adaptation, or translation without prior written permission
is prohibited, except as allowed under the copyright laws.
• Product Warranty
Agilent Technologies warrant Agilent Technologies hardware, accessories and
supplies against defects in materials and workmanship for the period of one year
from the warranty start date specified below. If Agilent Technologies receive
notice of such defects during the warranty period, Agilent Technologies will, at
its option, either repair or replace products which prove to be defective.
Replacement products may be either new or like-new.
Warranty service of this product will be performed at Agilent Technologies.
Buyer shall prepay shipping charges to Agilent Technologies and Agilent
Technologies shall pay shipping charges to return the product to Buyer.
However, Buyer shall pay all shipping charges, duties, and taxes for products
returned to Agilent Technologies from another country.
Agilent Technologies do not warrant that the operation of Agilent Technologies
products will be uninterrupted or error free. If Agilent is unable, within a
reasonable time, to repair or replace any product to a condition as warranted,
customer will be entitled to a refund of the purchase price upon prompt return of
the product.
The Agilent Technologies products may contain remanufactured parts
equivalent to new in performance or may have been subject to incidental use.
The warranty period begins on the date of delivery or on the date of installation
if installed by Agilent Technologies. If customer schedules or delays Agilent
Technologies installation more than 30 days after delivery, warranty begins on
the 31st day from delivery.
Warranty does not apply to defects resulting from (a) improper or inadequate
maintenance or calibration, (b) software, interfacing, parts or supplies not
supplied by Agilent Technologies, (c) unauthorized modification or misuse, (d)
operation outside of the published environmental specifications for the product,
or (e) improper site preparation or maintenance.
2 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
To the extent allowed by local law, the above warranties are exclusive and no
other warranty or condition, whether written or oral, is expressed or implied and
Agilent Technologies specifically disclaim any implied warranties or conditions
of merchantability, satisfactory quality, and fitness for a particular purpose.
Agilent Technologies will be liable for damage to tangible property per incident
up to the greater of $300,000 or the actual amount paid for the product that is the
subject of the claim, and for damages for bodily injury or death, to the extent
that all such damages are determined by a court of competent jurisdiction to
have been directly caused by a defective Agilent Technologies product.
To the extent allowed by local law, the remedies in this warranty statement are
customer’s sole and exclusive remedies. Expect as indicated above, in no event
will Agilent Technologies or its suppliers be liable for loss of date or for direct,
special, incidental, consequential (including lost profit or date), or other damage,
whether based in contract, tort, or otherwise.
For consumer transactions in Australia and New Zealand: the warranty terms
contained in this statement, except to the extent lawfully permitted, do not
exclude, restrict or modify and are in addition to the mandatory statutory rights
applicable to the sale of this product to you.
• Assistance
Product maintenance agreements and other customer assistance agreements are
available for Agilent Technologies products.
For any assistance, contact your nearest Agilent Technologies Sales Office.
• Certification
Agilent Technologies Inc. certifies that this product met its published
specifications at the time of shipment from the factory. Agilent further certifies
that its calibration measurements are traceable to the National Institute of
Standards and Technology (NIST), to the extent allowed by the Institute’s
calibration facility, and to the calibration facilities of other International
Standards Organization members.
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 3
Printing History
Edition 1: January 2001
Microsoft, Windows, Windows NT, Visial Basic, and Visual C/C++ are registered
trademarks of Microsoft Corporation.
Borland C/C++ Builder is registered trademark of International, Inc.
LabWindows and LabVIEW are registered trademarks of National Instruments
Corporation.
Prober Control Software (PCS) is a product of Cascade Michrotech, Inc.
4 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
In This Manual
This manual provides information about VXIplug&play driver for Agilent
4155/4156. This manual also introduces two sample application programs using
Agilent VEE and the VXIplug&play driver for the 4155/4156.
• Installation
This chapter describes hardware and software requirements to use
the 4155/4156 VXIplug&play driver, and how to install the driver.
• Driver Functions
This chapter lists the all driver functions for the 4155/4156 and Agilent E5250A
Low Leakage Switch Mainframe.
• Programming Examples Using Agilent VEE
This chapter describes how to create measurement program using Agilent VEE,
and provides programming examples.
• Sample Application Programs For Agilent VEE
This chapter provides how to install, execute, and modify the sample application
programs stored in the VEE Sample Program Disk furnished with the
4155/4156.
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 5
6 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Contents
1. Installation
Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Hardware Requirements with Agilent VEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Installing 4155/4156 Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
To Configure the Interface using Agilent I/O Library . . . . . . . . . . . . . . . . . . . . 1-6
To Install the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
2. Driver Functions
Driver Functions for the 4155/4156. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
hp4156b_abortMeasure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
hp4156b_addSampleSyncIv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
hp4156b_addSampleSyncPulse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
hp4156b_addStressSyncIv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
hp4156b_addStressSyncPulse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
hp4156b_autoCal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
hp4156b_clearSampleSync . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
hp4156b_clearStressSync. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
hp4156b_close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
hp4156b_cmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
hp4156b_cmdData_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
hp4156b_cmdInt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
hp4156b_cmdInt16Arr_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
hp4156b_cmdInt16_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
hp4156b_cmdInt32Arr_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
hp4156b_cmdInt32_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-13
hp4156b_cmdReal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
hp4156b_cmdReal64Arr_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
hp4156b_cmdReal64_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15
hp4156b_cmdString_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15
hp4156b_dcl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-15
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 Contents-1
Contents
hp4156b_error_message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
hp4156b_error_query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-16
hp4156b_errorQueryDetect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
hp4156b_errorQueryDetect_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-17
hp4156b_esr_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
hp4156b_execCal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-18
hp4156b_execOffsetCancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-19
hp4156b_force . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-20
hp4156b_forcePulse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-21
hp4156b_init . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22
hp4156b_measureM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-23
hp4156b_measureP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24
hp4156b_offsetCancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-24
hp4156b_opc_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25
hp4156b_readData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25
hp4156b_readStatusByte_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-26
hp4156b_recoverOutput. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-26
hp4156b_reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-26
hp4156b_revision_query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-27
hp4156b_sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-28
hp4156b_self_test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29
hp4156b_setFilter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30
hp4156b_setInteg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-30
hp4156b_setIv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-31
hp4156b_setPbias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-32
hp4156b_setPguR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-33
hp4156b_setPiv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-34
hp4156b_setSample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-35
hp4156b_setStress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-35
hp4156b_setSweepSync. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-36
hp4156b_setSwitch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-37
hp4156b_setVm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-37
Contents-2 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Contents
hp4156b_spotMeas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-38
hp4156b_startMeasure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-39
hp4156b_stopMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-40
hp4156b_stress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-41
hp4156b_sweepIv. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42
hp4156b_sweepMiv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-43
hp4156b_sweepPbias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-45
hp4156b_sweepPiv. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-46
hp4156b_timeOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-47
hp4156b_timeOut_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-47
hp4156b_zeroOutput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-47
Driver Functions for the E5250A. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-48
hpe5250a_biasChanCard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-50
hpe5250a_biasChanList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-50
hpe5250a_biasChanList_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-51
hpe5250a_biasPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52
hpe5250a_biasState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-52
hpe5250a_close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-53
hpe5250a_closeCard_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-53
hpe5250a_closeList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-54
hpe5250a_closeList_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-55
hpe5250a_cmd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-55
hpe5250a_cmdData_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56
hpe5250a_cmdInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56
hpe5250a_cmdInt16Arr_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-57
hpe5250a_cmdInt16_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-57
hpe5250a_cmdInt32Arr_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-58
hpe5250a_cmdInt32_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-58
hpe5250a_cmdReal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-59
hpe5250a_cmdReal64Arr_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-59
hpe5250a_cmdReal64_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-60
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 Contents-3
Contents
hpe5250a_cmdString_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-60
hpe5250a_compenC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-61
hpe5250a_connRuleSeq. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-62
hpe5250a_couplePort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-63
hpe5250a_coupleState . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-64
hpe5250a_dcl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-64
hpe5250a_error_message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-65
hpe5250a_error_query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-65
hpe5250a_errorQueryDetect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-66
hpe5250a_errorQueryDetect_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-66
hpe5250a_esr_Q. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-67
hpe5250a_func . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-67
hpe5250a_init. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-68
hpe5250a_opc_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-68
hpe5250a_openCard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-69
hpe5250a_openList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-69
hpe5250a_openList_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-70
hpe5250a_readStatusByte_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-70
hpe5250a_reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-71
hpe5250a_revision_query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-71
hpe5250a_selectCompenFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-72
hpe5250a_self_test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-73
hpe5250a_testClear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-73
hpe5250a_testExec_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-74
hpe5250a_timeOut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-74
hpe5250a_timeOut_Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-74
3. Programming Examples Using Agilent VEE
Programming Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Registrating the Driver on Agilent VEE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Basic Objects to Control the Instrument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
Contents-4 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Contents
Debugging Your Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
Restrictions When Using the Driver with Agilent VEE. . . . . . . . . . . . . . . . . . 3-16
High-Speed Spot Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-17
Multi-Channel Spot Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19
Staircase Sweep Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-22
Synchronous Sweep Measurements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
Multi-Channel Sweep Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-26
Pulsed Spot Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-30
Multi-Channel Pulsed Spot Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-32
Pulsed Sweep Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-34
Multi-Channel Pulsed Sweep Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-36
Staircase Sweep with Pulsed Bias Measurements . . . . . . . . . . . . . . . . . . . . . . . . 3-39
Sampling Measurements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-41
Stress Force . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-45
4. Sample Application Programs for Agilent VEE
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Agilent VEE Sample Program Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
What are Sample Programs? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Required Equipment and Accessories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
Installing the Sample Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10
Using sample1.vee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11
Program Execution Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
Panel Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14
To Execute sample1.vee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 Contents-5
Contents
Using sample2.vee . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
Program Execution Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20
Panel Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22
To Execute sample2.vee. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
Customizing Sample Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
To Change an GPIB Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28
To Change the Vth Measurement Setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
To Remove a Test Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30
To Remove a Source Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32
To Add a Test Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
To Add a Measurement Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
Contents-6 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
1 Installation
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Installation
This chapter explains the environment requirements and installation of the
VXIplug&play driver for Agilent 4155/4156.
•“Software Requirements”
•“Hardware Requirements with Agilent VEE”
•“Installing 4155/4156 Driver”
NOTE The hardware required depends on the operating system and programming language
used. This manual provides hardware requirements when using the driver with
Agilent VEE software. When using the driver with a programming language other
than Agilent VEE, refer to the appropriate programming manual.
1-2 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Installation
Software Requirements
Software Requirements
The following software is required to use the VXIplug&play driver for the
4155/4156. You can select one from Windows NT and Windows 95. You can also
select the most comfortable programming language to develop and run programs.
• Operating System
• Windows NT revision 3.51 or later
• Windows 95
• 32-bit VISA I/O Library
I/O Library for GPIB Interface Card, or equivalent
• Programming Environment
• Agilent VEE
• Microsoft Visual Basic
• Microsoft Visual C++
• Borland C/C++
• LabView
• LabWindows
• VXIplug&play Driver Disk (furnished with the 4155/4156)
• 4155/4156 Plug&Play Driver Disk
• E5250A Plug&Play Driver Disk
NOTE If you use the sample application programs, stored in the VEE Sample Program
Disk furnished with the 4155/4156, VEE software must be version 4.0 or later.
See Chapter 4. Also, if you use the Cascade Microtech Summit series semi-auto
prober, confirm the operating system supported by the prober control software
(PCS) supplied from Cascade Microtech, Inc. PCS version 2.50 supports Windows
95 and Windows 3.1.
NOTE The E5250A Plug&Play Driver Disk stores the VXIplug&play driver for Agilent
E5250A. This driver is required to use the sample application programs.
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 1-3
Installation
Hardware Requirements with Agilent VEE
Hardware Requirements with Agilent VEE
The following hardware is required to use Agilent VEE and the VXIplug&play
drivers.
• Controller
• 486/66 with Coprocessor (minimum recommendation)
• 586(Pentium)/90 or better is recommended.
• Memory
• For Windows 95: 16 Mbyte. 24 Mbyte or more is recommended.
• For Windows NT: 24 Mbyte. 32 Mbyte or more is recommended.
• Hard disk (minimum disk space)
• 20 Mbytes for Agilent VEE (HP VEE version 4.0)
• 2 Mbytes for 4155/4156 driver
• 1 Mbyte for E5250A driver
• Graphics
1024 × 768. 1280 × 1024 is recommended.
• IEEE 488 Interface card
Agilent 82341C GPIB Interface Card, or equivalent.
• CD-ROM drive
A CD-ROM drive will be required to install the software needed to use the
VXIplug&play driver.
• Flexible disk drive
A 3.5 inch flexible disk drive is required to install the drivers.
1-4 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Installation
Installing 4155/4156 Driver
Installing 4155/4156 Driver
The installation flow for the VXIplug&play driver is shown below. If you have
already installed the IEEE 488 interface card, VISA I/O library, and programming
software on your PC, skip steps 1 through 4.
1. Install the IEEE 488 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.
Follow the instructions in the I/O library’s setup program.
3. Configure and check the IEEE 488 interface.
See the I/O library manual. If you use the Agilent I/O Library, also see “To
Configure the Interface using Agilent I/O Library” on page 1-6.
4. Install the programming software.
Follow the setup program instructions.
5. Install the VXIplug&play driver.
See “To Install the Driver” on page 1-7.
6. Register the driver in the programming software.
See the programming software manual. If you are using Agilent VEE, also see
“Programming Basics” in Chapter 3.
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 1-5
Installation
Installing 4155/4156 Driver
To Configure the Interface using Agilent I/O Library
After installing the IEEE 488 interface card and the Agilent I/O Library, configure
the interface. The procedure shown below is the easiest way to configure the
interface. First, execute I_O Config in the HP I_O Libraries folder. The I/O Config
window is displayed. See Figure 1-1.
1. Click Auto Add.
If the interface card is installed properly, I_O Config automatically detects the
hardware configuration. The default names for SICL and VISA are assigned and
listed, as shown in the Configured Interface list.
2. Click hpib7 GPIB0.
3. Click Edit to display the Configuration dialog box for the interface card.
If you find any conflicts in the dialog box, such as IRQ line, you may need to
change them manually. Normally you can exit without modifying the default
setup.
4. Click OK to exit. Reboot your PC to configure the interface.
Figure 1-1 To Configure the Interface using Agilent I/O Library
NOTE VISA Name is used by the VXIplug&play drivers to access the interface.
1-6 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Installation
Installing 4155/4156 Driver
To Install the Driver
1. Insert the 4155/4156 Plug&Play Driver Disk into the flexible disk drive
connected to your PC.
2. Execute the 4156B.EXE program stored on the diskette. The program
automatically installs the driver in the following directory.
• For Windows NT: \Vxipnp\Winnt\Hp4156b
• For Windows 95: \Vxipnp\Win95\Hp4156b
Following files are installed in the directory.
• hp4156b.bas
• hp4156b.c
• hp4156b.def
• hp4156b.fp
• hp4156b.GID
• hp4156b.h
• hp4156b.hlp
• readme.txt
• DelsL1.isu
3. If you are also installing the driver for the E5250A, do the following.
a. Insert the E5250A Plug&Play Driver Disk into the flexible disk drive
connected to your PC.
b. Execute the E5250A.EXE program stored on the diskette. The program
automatically installs the driver in the following directory.
• For Windows NT: \Vxipnp\Winnt\Hpe5250a
• For Windows 95: \Vxipnp\Win95\Hpe5250a
Following files are installed in the directory.
• hpe5250a.bas
• hpe5250a.c
• hpe5250a.def
• hpe5250a.fp
• hpe5250a.GID
• hpe5250a.h
• hpe5250a.hlp
• readme.txt
• DelsL1.isu
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 1-7
Installation
Installing 4155/4156 Driver
1-8 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
2 Driver Functions
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Driver Functions
This section explains all the driver finctions available for Agilent 41555/4156 and
Agilent E5250A.
•“Driver Functions for the 4155/4156”
•“Driver Functions for the E5250A”
NOTE For additional information on each function. refer to the on-line help for the
VXIplug&play drivers, or open the hp4156b.hlp or hpe5250a.hlp file in the
direcroty the driver is installed. See “Installing 4155/4156 Driver” in Chpater 1.
2-2 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Driver Functions for the 4155/4156
Table 2-1 lists all the functions for the 4155/4156. 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 2-1 4155/4156 Driver Function Lists
Category Function Description
Miscellaneous hp4156b_init Initializes the 4155/4156.
hp4156b_close Closes the connection with the 4155/4156.
hp4156b_reset Executes the 4155/4156 reset.
hp4156b_self_test Executes the 4155/4156 self-test.
hp4156b_error_query Queries the 4155/4156 for error code/message.
hp4156b_error_message Queries for the driver errors.
hp4156b_revision_query Queries for the 4155/4156 firmware/driver revisions.
hp4156b_timeOut Sets the timeout.
hp4156b_timeOut_Q Queries for the timeout setting.
hp4156b_errorQueryDetect Sets the automatic error checking.
hp4156b_errorQueryDetect_Q Queries for the automatic error checking setting.
hp4156b_dcl Sends the Device Clear.
hp4156b_esr_Q Queries the ESR status.
hp4156b_readStatusByte_Q Reads the 4155/4156 status byte.
hp4156b_opc_Q Checks the 4155/4156 operation completion status.
Primitive
Measurement
Functions
Calibration hp4156b_autoCal Sets the auto calibration mode
Zero Offset
Cancel
hp4156b_startMeasure Starts a measurement.
hp4156b_readData Reads a measurement result.
hp4156b_stopMode Sets the measurement completion mode.
hp4156b_abortMeasure Aborts output or measurement.
hp4156b_execCal Executes the 4155/4156 calibration
hp4156b_offsetCancel Sets the zero offset cancel.
hp4156b_execOffsetCancel Executes the zero offset cancel.
Driver Functions
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 2-3
Driver Functions
Category Function Description
Measurement
Unit Setup
hp4156b_setSwitch Sets the output switch.
hp4156b_setFilter Sets the output filter.
hp4156b_setInteg Sets the integration time.
hp4156b_setVm Sets the VMU measurement mode.
hp4156b_setPguR Sets the PGU output impedance.
Source Setup hp4156b_force Applies a dc current or voltage.
hp4156b_forcePulse Applies a pulse by using PGU.
hp4156b_zeroOutput Disables output.
hp4156b_recoverOutput Recovers output.
hp4156b_setIv Sets the sweep source.
hp4156b_setPbias Sets the pulsed bias source.
hp4156b_setPiv Sets the pulsed sweep source.
hp4156b_setSweepSync Sets the synchronous sweep source.
Measurement
Execution
hp4156b_spotMeas Executes a high speed spot measurement.
hp4156b_measureM Executes a multi-channel spot measurement.
hp4156b_sweepIv Executes a one channel sweep measurement.
hp4156b_sweepMiv Executes a multi-channel sweep measurement.
hp4156b_measureP Executes a pulsed spot measurement.
hp4156b_sweepPiv Executes a pulsed sweep measurement.
hp4156b_sweepPbias Executes a sweep measurement with pulsed bias.
Sampling
Measurements
hp4156b_setSample Sets the timing parameters.
hp4156b_addSampleSynclv Sets the dc source.
hp4156b_addSampleSyncPulse Sets the pulse source.
hp4156b_sample Executes a sampling measurement.
hp4156b_clearSampleSync Clears the source setup.
Stress Force hp4156b_setStress Sets the timing parameters.
hp4156b_addStressSyncIv Sets the dc stress source.
hp4156b_addStressSyncPulse Sets the pulse stress source.
hp4156b_stress Forces stress.
hp4156b_clearStressSync Clears the source setup.
2-4 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Category Function Description
Passthrough
Functions
hp4156b_cmd Sends a command.
h4156b_cmdInt Sends a command with an integer parameter.
hp4156b_cmdReal Sends a command with a real parameter.
hp4156b_cmdData_Q Sends a command to read any data.
hp4156b_cmdString_Q Sends a command to read string response.
hp4156b_cmdInt16_Q Sends a command to read 16 bit integer response.
hp4156b_cmdInt16Arr_Q Sends a command to read 16 bit integer array response.
hp4156b_cmdInt32_Q Sends a command to read 32 bit integer response.
hp4156b_cmdInt32Arr_Q Sends a command to read 32 bit integer array response.
hp4156b_cmdReal64_Q Sends a command to read 64 bit real response.
hp4156b_cmdReal64Arr_Q Sends a command to read 64 bit real array response.
Driver Functions
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 2-5
Driver Functions
hp4156b_abortMeasure
hp4156b_abortMeasure
This function aborts the 4155/4156’s present operation, such as the measurement
executed by the hp4156b_startMeasure function, the pulse output by the
hp4156b_forcePulse function, the stress force by the hp4156b_stress function, and
so on.
Syntax ViStatus _VI_FUNC hp4156b_abortMeasure(ViSession vi);
Parameters vi Instrument handle returned from hp4156b_init( ).
hp4156b_addSampleSyncIv
This function specifies the constant current source or constant voltage source used
for the sampling measurements, and sets the parameters. Source output starts at the
beginning of the sampling measurement (beginning of the hold time), and stops at
the end of the last sampling measurement point.
Sampling measurement channels are defined by the hp4156b_sample function, and
sampling measurement timing is defined by the hp4156b_setSample function.
Syntax ViStatus _VI_FUNC hp4156b_addSampleSyncIv(ViSession vi, ViInt32 channel,
ViInt32 mode, ViReal64 range, ViReal64 base, ViReal64 bias, ViReal64 comp);
Parameters vi Instrument handle returned from hp4156b_init( ).
channel Channel number of the source unit. 1 to 6 (SMU1 to SMU6),
21 (VSU1), 22 (VSU2), 27 (PGU1), or 28 (PGU2)
mode Output mode. 1 (current output, only for SMU) or 2 (voltage
output).
range Output range. 0 (auto ranging) or positive value (limited auto
ranging). See below.
For current output: 1E-11 to 1.0 A, or 0.
For voltage output: 2.0 to 200.0 V, or 0.
base Base value. -1.0 to 1.0 A for current output, -200.0 V to 200.0 V
for voltage output.
bias Bias value. -1.0 to 1.0 A for current output, -200.0 V to 200.0 V
for voltage output.
comp Compliance value. -200.0 V to 200.0 V for voltage compliance,
-1.0 to 1.0 A for current compliance.
2-6 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Driver Functions
hp4156b_addSampleSyncPulse
hp4156b_addSampleSyncPulse
This function specifies the pulse source (PGU) used for the sampling measurements,
and sets the parameters. Pulse outputs start at the beginning of the sampling
measurement (beginning of the hold time), and stop at the end of the last sampling
measurement point or stop at the last pulse if it comes earlier than the last sampling
measurement point.
Sampling measurement channels are defined by the hp4156b_sample function, and
sampling measurement timing is defined by the hp4156b_setSample function.
If you want to let the pulse output synchronize with the sampling measurement
timing, you should define carefully both the hp4156b_addSampleSyncPulse timing
parameters (count, period, width, delay, rise and fall) and the hp4156b_setSample
timing parameters.
Syntax ViStatus _VI_FUNC hp4156b_addSampleSyncPulse(ViSession vi, ViInt32 channel,
ViReal64 base, ViReal64 peak, ViInt32 count, ViReal64 period, ViReal64 width,
ViReal64 delay, ViReal64 rise, ViReal64 fall);
Parameters vi Instrument handle returned from hp4156b_init( ).
channel Channel number of the pulse generator unit.
27 (PGU1) or 28 (PGU2)
base Pulse base value. -40.0 to 40.0 V.
peak Pulse peak value. -40.0 to 40.0 V.
count Pulse count (number of pulses). 1 to 65535, or 0 (free run
mode).
period Pulse period. 1E-6 to 10.0 seconds.
width Pulse width. 1E-6 to 9.99 seconds.
delay Pulse delay time. 0.0 to 10.0 seconds.
rise Pulse leading time. 0.1E-6 to 10E-3 seconds.
fall Pulse trailling time. 0.1E-6 to 10E-3 seconds.
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 2-7
Driver Functions
hp4156b_addStressSyncIv
hp4156b_addStressSyncIv
This function specifies the DC stress source, and sets the parameters. You can use
maximum 4 stress sources at once by using the hp4156b_addStressSyncIv and/or
hp4156b_addStressSyncPulse functions.
Syntax ViStatus _VI_FUNC hp4156b_addStressSyncIv(ViSession vi, ViInt32 source,
ViInt32 channel, ViInt32 mode, ViReal64 range, ViReal64 base, ViReal64 stress,
ViReal64 comp);
Parameters vi Instrument handle returned from hp4156b_init( ).
source Reference number of the stress source. 1, 2, 3, or 4.
channel Channel number of the stress source.
1 to 6 (SMU1 to SMU6), 21 (VSU1), 22 (VSU2), 27 (PGU1),
or 28 (PGU2)
mode Output mode. 1 (current output, only for SMU) or 2 (voltage
output).
range Output range. 0 (auto ranging) or positive value (limited auto
ranging). See below.
For current output: 1E-11 to 1.0 A, or 0.
For voltage output: 2.0 to 200.0 V, or 0.
base Base value. -1.0 to 1.0 A for current output, -200.0 V to 200.0 V
for voltage output.
stress Stress value. -1.0 to 1.0 A for current output, -200.0 V to 200.0
V for voltage output.
comp Compliance value. -200.0 V to 200.0 V for voltage compliance,
-1.0 to 1.0 A for current compliance.
2-8 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Driver Functions
hp4156b_addStressSyncPulse
hp4156b_addStressSyncPulse
This function specifies the pulse stress source (PGU), and sets the parameters. You
can use maximum 4 stress sources at once by using the hp4156b_addStressSyncIv
and/or hp4156b_addStressSyncPulse functions. See “hp4156b_stress” on page 41
for the setting of width and delay.
Syntax ViStatus _VI_FUNC hp4156b_addStressSyncPulse(ViSession vi, ViInt32 source,
ViInt32 channel, ViReal64 base, ViReal64 stress, ViReal64 width, ViReal64 delay,
ViReal64 rise, ViReal64 fall);
Parameters vi Instrument handle returned from hp4156b_init( ).
source Reference number of the stress source. 1, 2, 3, or 4.
channel Channel number of the pulse generator unit.
27 (PGU1) or 28 (PGU2)
base Stress pulse base value. -40.0 to 40.0 V.
stress Stress pulse peak value. -40.0 to 40.0 V.
width Pulse width. 1E-6 to 9.99 seconds.
delay Pulse delay time. 0.0 to 10.0 seconds.
rise Pulse leading time. 0.1E-6 to 10E-3 seconds.
fall Pulse trailling time. 0.1E-6 to 10E-3 seconds.
hp4156b_autoCal
This function enables or disables the auto calibration function.
Syntax ViStatus _VI_FUNC hp4156b_autoCal(ViSession vi, ViInt32 state);
Parameters vi Instrument handle returned from hp4156b_init( ).
state Auto calibration mode. 0 (OFF) or 1 (ON).
Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1 2-9
Driver Functions
hp4156b_clearSampleSync
hp4156b_clearSampleSync
This function clears the settings of the constant voltage/current source defined by
the hp4156b_addSampleSyncIv function, and the settings of the pulse source
defined by the hp4156b_addSampleSyncPulse function.
Syntax ViStatus _VI_FUNC hp4156b_clearSampleSync(ViSession vi);
Parameters vi Instrument handle returned from hp4156b_init( ).
hp4156b_clearStressSync
This function clears the settings of the stress sources defined by the
hp4156b_addStressSyncIv function and the hp4156b_addStressSyncPulse function.
Syntax ViStatus _VI_FUNC hp4156b_clearStressSync(ViSession vi);
Parameters vi Instrument handle returned from hp4156b_init( ).
hp4156b_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 hp4156b_close(ViSession vi);
Parameters vi Instrument handle returned from hp4156b_init( ).
hp4156b_cmd
This function passes the cmd_str string to the instrument. Must be a NULL
terminated C string.
Syntax ViStatus _VI_FUNC hp4156b_cmd(ViSession vi, ViString cmd_str);
Parameters vi Instrument handle returned from hp4156b_init( ).
cmd_str Instrument command (cannot exceed 256 bytes in length).
2-10 Agilent 4155C/4156C VXIplug&play Driver User’s Guide, Edition 1
Loading...