[opengtoolkit-cvs] portIO/source ogportio.dll,NONE,1.1 ogportio.sys,NONE,1.1 readme.txt,NONE,1.1

[<lab...@us...>]

Update of /cvsroot/opengtoolkit/portIO/source
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv12704/source

Added Files:
	ogportio.dll ogportio.sys readme.txt 
Log Message:
First release version of Port IO VI library with according Windows NT device driver.

--- NEW FILE: ogportio.dll ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: ogportio.sys ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: readme.txt ---
/*
 * Generic Port IO library for LabVIEW for Windows 9x/ME/NT/2000/XP/2003
 *
 * Copyright (C) 2004 Rolf Kalbermatter, r.k...@hc...
 *
 * Please visit http://www.OpenG.org to learn about the
 * Open Source LabVIEW software movement.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

1) Introduction
---------------

With this library it is possible to access Port IO from within LabVIEW
in a uniform way. It comes with a LabVIEW VI library, a shared library
to access from LabVIEW, and a device driver which is used under
Windows NT (NT 4, 2000, XP, 2003) based systems to access the low level
kernel functionality necessary for this library.

This library consists of four parts:

readme.txt          This file
ogportio.llb        LabVIEW VI library for LabVIEW 6.0 and higher
ogportio.dll        Shared library implementing Port IO functionality
ogportio.sys        Device Driver for Windows NT based systems


2) Installation
---------------

The shared library will work directly on Windows 9x/ME systems as they
need no device driver support to access the CPU port IO space.

On Windows NT (NT4/2000/XP/2003) the shared library will check for
the device driver and automatically install it if this is necessary.
For this to work you need to be logged in with administrator rights
the first time you want to use this library. Also the ogportio.sys
must be in the same directory as the ogportio.dll.

Once the device driver is installed it is not anymore necessary to have administrator rights to access the libraries functionality except for
the uninstall function.


3) Uninstallation
-----------------

Once you do not need the port IO library anymore you can remove the
device driver by calling the "PORT IO Uninstall.vi" function. For this
you also need to be logged in with administrator rights, and this
function will remove the port IO driver from the service database
of your Windows NT based system. The driver will then be unavailable
but not be removed from the %WINNT%\system32\drivers directory.


4) Communication
----------------

If you have bug reports or suggestions to the functionality of this
library it is probably best to direct them to the Open-G support list
for this library on sourceforge.


5) Building your own
--------------------

In addition the source code for the shared library and device driver are available in a separate directory c_source. This directory contains the Visual C 6 workspace file ogportio.dsw to create the shared library. The library is quite simple and should be compilable with little or no changes
by other Windows 32 bit compatible C compilers such as LabWindows CVI,
MingW, Watcom C, Borland C, and Symantec C, but no tests have been done
nor support will be available for this. You should know your compiler environment quite well, if you want to attempt to build the shared
library yourself with it.

The device driver itself can probably only be built with an installed
Windows NT or Windows 2000 DDK and that needs a full version of the
Visual C compiler for some of the build tools as well.

Refer to the DDK documentation which came with your DDK installation
to what you will need exactly and how to build the device driver from
the sources. Basically after having setup your DDK environment in a
command shell you will have to move to the directory containing the
sources and type "build".