README for VISA
$VERSION = 1.11
===============

This library offers a perl interface to National Instrument's NI-VISA library.

With this library you can easily control the instruments in your lab (multimeters, voltage
sources, magnet sources, pulse generators etc.) from perl. You can perform
complicated measurement jobs with just some perl loops.

It comes even better. The general VISA::Instrument class reduces the
communication overhead to a minimum. And the specialized instrument classes
(virtual instruments) like the VISA::Instrument::HP34401A class offer
even more high level comfort. Everything is prepared and waiting for you.


INSTALLATION
------------

This library has been tested to work on Linux and Windows. Installation is trivial
since precompiled binary .ppm files are available for Windows and Linux (for perl 5.8.x).

Before you start, you must have the VISA library by National Instrument
installed. If you plan to use GPIB connections (which is very likely), you must also
have the necessary drivers (NI-488.2) for your GPIB adapter card installed. Refer to the good
documentation by National Instrument to find out, how to install these packages.

See National Instrument's website at

 http://digital.ni.com/softlib.nsf/webcategories/85256410006C055586256BBB002C0E91?opendocument&node=132060_US

 http://ni.com/linux/ni488dl.htm


Now simply install the ppm distribution of the module with (same for Windows and Linux)

 ppm install http://www.nano.physik.uni-muenchen.de/svn/lab/trunk/VISA/Lab-VISA.ppd

That's it!


BUILDING
--------

If you want to build the module yourself, you will need a compiler and a make program.
On Windows the make program is called 'nmake', so replace the 'make' command in the
instructions below with 'nmake'. I successfully used the freely available Visual C++ 2005
on Windows.

If you also want to re-generate the wrapper code from the Swig description file (visa.i),
you must have Swig installed. Uncomment the swig line in the Makefile.PL to run swig.

To build and install this module, type the following commands. Windows users replace
'make' by 'nmake'.

   perl Makefile.PL
   make
   make install

In case the compiler or linker cannot find certain include files (e.g. visa.h) or libraries,
adjust the platform specific lines in Makefile.PL where indicated. They are currently set
to match my local setup. Don't know if these things could ever be found automatically.


COPYRIGHT AND LICENCE
---------------------

Copyright (C) 2004/2005 Daniel Schrer

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself. 

