========================================================================
This package provides windows version of
- Base HPI library (libopenhpi.dll)
- OpenHPI utils library (libopenhpiutils.dll)
- OpenHPI marshal library (libopenhpimarshal.dll)
- OpenHPI transport library (libopenhpitransport.dll)
- OpenHPI clients:
-- hpialarms.exe
-- hpidomain.exe
-- hpiel.exe
-- hpievents.exe
-- hpifan.exe
-- hpigensimdata.exe
-- hpiinv.exe
-- hpionIBMblade.exe
-- hpipower.exe
-- hpireset.exe
-- hpisensor.exe
-- hpisettime.exe
-- hpithres.exe
-- hpitop.exe
-- hpitree.exe
-- hpiwdt.exe
-- hpixml.exe
-- ohdomainlist.exe
-- ohhandler.exe
-- ohparam.exe
- OpenHPI daemon as a console Windows application (openhpid.exe)
-- Slave plug-in (libslave.dll)
-- Test Agent plug-in (libtest_agent.dll)

The package also provides necessary glib2 libraries:
- libglib-2.0-0.dll
- libgthread-2.0-0.dll
- libgmodule-2.0-0.dll

NB: glib2 libraries were obtained in binary form from 
http://www.gtk.org/download-windows.html and were included 
without any change.
NB: glib2 is distributed under LGPL2 license.

The package can include additional auxiliary libraries.

========================================================================
Dependencies:

The only dependence (save for mingw compiler) is glib2.
Windows version can be obtained at http://www.gtk.org/download-windows.html

========================================================================
Current windows build system supports only mingw compiler.
http://www.mingw.org/
However the built libraries can be use as ordinary windows DLL
in projects with any compiler.

========================================================================
Build instructions:

- Get mingw (cross or native).
- Get archive with glib2 for windows and unpack it somewhere.
- Enter OpenHPI source tree root directory.
- Modify Makefile.mingw32.def:
-- ARCH in order to point architecture for produced binaries
-- TOOLCHAIN_PATH in order that CC, CXX, AS and RC point to correct files.
-- GLIB_DIR: in order that GLIB_INCLUDES and GLIB_LIBS
   point to valid directories with glib headers and libraries.
- Run "make -f Makefile.mingw32".
- Run "make -f Makefile.mingw32 out".
- The openhpi-${VERSION}-win32-${ARCH} sub-directory will contain all produced stuff.
- For gcc4-based compiler (i.e. mingw-w64.sourceforge.net ) you need to copy more libs:
-- libgcc_s_*.dll
-- libstdc++-*.dll
- Optional step - strip produced exe and dll files.

========================================================================
Client Usage instructions:

There are two ways:

Way 1) prepare openhpiclient.conf and set env. var. OPENHPICLIENT_CONF
to its path

Way 2) set env. var. OPENHPI_DAEMON_HOST to OpenHPI daemon address.

========================================================================
Library Usage instructions:

Header file SaHpi.h contains declarations on provided HPI functions.
Header file oHpi.h contains declarations on provided OpenHPI extension functions.
Make sure to use the oHpi.h and SaHpi.h files from  openhpi-3.3.0-win32-x86 or 
openhpi-3.3.0-win32-amd64 directory, not the ones from trunk/include directory.
The functions are in libopenhpi.dll.

Define "SAHPI_API" macro as "__declspec(dllimport)".

For mingw compiler it can be just linked.

For MSVC:
- There is def file libopenhpi.def
- With lib tool you can create import library
- Command example "lib /machine:i386 /def:libopenhpi.def"
- Point produced import library in Project settings

For application running and distribution::
- copy necessary libraries to your application dir.

And see Client Usage instructions about configuring OpenHPI daemon address
to connect.

========================================================================
Library Known Issues:

===================================================
Seems mingw has its own copy of environment variables.
So the code:

    _putenv("OPENHPI_DAEMON_HOST=...");
    rv = saHpiSessionOpen(...)

does not work in MSVC as expected.
But setting any variable before running executable works!

===================================================
Seems client applications do not close sockets.
The sockets remain in TIME_WAIT state.
It can exhaust system resources.

========================================================================
Daemon Usage instructions:

Only Slave plug-in and Test agent plug-in are now ported under Windows.

- prepare openhpi.conf
- openhpid.exe -v -c "path to openhpi.conf"

As an optional step you can do 
- set OPENHPI_UID_MAP="path to uid map file"
before running openhpid.exe.
The uid map file will be used for persistent
resource id <-> entity path mapping.

NB: -v is optional flag for verbose messages.

========================================================================
Troubleshouting:

Mailing list: openhpi-devel@lists.sourceforge.net

or

IRC channel #openhpi on FreeNode.