Agilent Technologies

Agilent E1458 VXIplug&play Instrument Driver Read Me

README.TXT for Agilent E1458 96-Channel Digital Input / Output

Contents:

1 Introduction

2 VISA Specific Information
2.1 Instrument Addresses
2.2 Executing the Soft Front Panel without VISA

3 Using the Agilent E1458 Driver in Application Development Environments
3.1 Microsoft Visual C/C++
3.2 Borland C/C++
3.3 Microsoft Visual Basic

4.0 Known Defects

5.0 Online Information

6.0 Revision History

- ---------------------------------------------------------------------------

1. Introduction

The help file included with the Agilent E1458 VXIplug&play driver
contains instrument and programming information. This readme file
contains additional information for the VXIplug&play programmer.

- ---------------------------------------------------------------------------

2. VISA Specific Information

The following topics refer to instances when the driver is used with
different versions of VISA.

2.1 Instrument Addresses

When using VXIplug&play instrument drivers, instrument addresses must
be all uppercase letters. Implementation of the addressing scheme is
vendor specific and some vendors support mixed cases. However, for
maximum portability, the instrument address should use uppercase
characters only.

For example: use "VXI0::144::INSTR" instead of "vxi0::144::instr"

2.2 Executing the Soft Front Panel without VISA

The VISA dynamic link library provides a communication library
between your program and the instrument. The SFP may be executed without
VISA or without the HPE1458.dll present. It will do a partial emulation
of the hardware for demo purposes.

- --------------------------------------------------------------------------

3. Using the E1458 Driver in Application Development Environments

This section offers suggestions on using the hpe1458.dll within
various application development environments.

3.1 Microsoft Visual C/C++

Refer to your Microsoft Visual C/C++ manuals for information on linking
and calling .DLLs.

3.2 Borland C/C++

Refer to your Borland C/C++ manuals for information on linking and
calling .DLLs.

3.3 Microsoft Visual Basic

Refer to the Microsoft Visual BASIC manual for information on calling DLLs.
The BASIC include file is hpe1458.bas, which is contained in the directory
~winntinclude or ~win95include. The ~ refers to the directory in the
VXIPNPPATH variable. By default this is set to C:VXIPNP on Agilent I/O
Libraries revisions prior to J.01.00; or to C:Program FilesVISA on
revisions J.01.00 or later.


- ---------------------------------------------------------------------------

4.0 Known Defects

4.1 hpe1458_traceData_Q() has a char array (traceData[]). This array
is not NULL terminated by the instrument and therefor the instrument
manuals only indicate the need to allocate the array to the size of
the trace. However, some Plug&Play platforms treat char arrays as
if they were strings -- and expect a NULL terminator. The user should
allocate the char array to an extra byte so that a NULL terminator will
be present at the end of the array when the platform treats this char
array as a string.

- ---------------------------------------------------------------------------

5.0 Online Information

The latest copy of this instrument driver and other Agilent instrument
drivers are available at the Agilent Technologies customer WWW site:

http://www.agilent.com/find/inst_drivers

The hpe1458 driver is located in a self-extracting archive file called
e1458.exe.

If you do not have Internet access, the drivers can be obtained by
contacting your country support organization. In the US, the phone
number is 800-452-4844. A list of contact information for other
countries is available on the Agilent Technologies website:

http://www.agilent.com/find/assist


- ---------------------------------------------------------------------------

6.0 Revision History

A.01.00 June 14, 1996 Initial Release.
A.02.00 November 14, 1996 WIN32 Release.
A.02.02 April 3, 1998 Fixed High Speed computer problems
hpe1458_32.dll A.02.02
hps1458.exe A.02.02
hpdig_i32v.dll G.05.04

A.02.03 September 10, 1998
Changed the C-SCPI dll to work better with the E8491 interface.
Corrected hpe1458.bas.
hpe1458_32.dll A.02.02
hps1458.exe A.02.02
hpdig_i32v.dll G.05.05

A.02.06 July 9, 1999
More changes to the C-SCPI dll for faster E8491 operation.
hpe1458_32.dll A.02.06
hps1458.exe A.02.06
hpdig_i32v.dll G.05.06
visaext.dll H.01.00.01
hpvscp32.dll G.03.03

A.02.07 October 30, 2001
Agilent rebranding
hpe1458_32.dll A.02.07
hps1458.exe A.02.07
hpdig_i32v.dll G.05.07
visaext.dll K.01.00.00
hpvscp32.dll G.03.04

- ---------------------------------------------------------------------------


© Agilent 2000-2006