summaryrefslogtreecommitdiff
path: root/INSTALL_WIN.txt
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL_WIN.txt')
-rw-r--r--INSTALL_WIN.txt67
1 files changed, 67 insertions, 0 deletions
diff --git a/INSTALL_WIN.txt b/INSTALL_WIN.txt
new file mode 100644
index 0000000..23223c5
--- /dev/null
+++ b/INSTALL_WIN.txt
@@ -0,0 +1,67 @@
+Installation Instructions for Windows
+*************************************
+
+If you are compiling for MinGW or cygwin, please refer to the INSTALL file.
+
+If you are using Microsoft Visual Studio:
+- Open the relevant solution file libusb.dsw for MSVC6, libusb.sln for Visual
+ Studio 2005 or later (you will go through a short conversion process if using
+ 2008)
+- If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
+ in config.h
+- Select your configuration and compile the project
+
+Note that if you are using Visual Studio Express, you will not be able to
+compile the 64 bit version of the library.
+
+If you are using the freely available Windows DDK (Driver Development Kit)
+- If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
+ in config.h
+- Open one of the relevant Free Build or Checked Build prompt for your target
+ platform
+- Navigate to the directory where the source is located and run ddk_build.cmd
+
+Note that using the Windows DDK, it is possible to compile both the 32 and 64
+bit versions of the library. The DDK build is currently set to produce only the
+DLL however.
+
+
+Destination directories
+***********************
+
+The 32 bit binaries compiled either from Visual Studio or the DDK are placed in
+a Win32\ directory at the root of the library
+The 64 bit binaries are placed in an x64 directory
+
+- If needed, edit msvc/config.h according to your needs (you might want to
+ comment out ENABLE_DEBUG_LOGGING for instance).
+
+That's it! You should now be able to compile the solution.
+
+
+Troubleshooting
+***************
+
+If the compilation process complains about missing libraries, you need to ensure
+that the default library paths for your project point to a directory that
+contains setupapi.lib and ole32.lib.
+If needed, these libraries can be obtained by installing either the latest
+Windows SDK or the DDK (Links provided at the end of this file).
+
+The 64 bit version of the library has been tested at least as much as the 32 bit
+version during development. Same goes for Windows 7 vs Vista/XP.
+Therefore we do not expect specific issues related to using these targets with
+libusb.
+
+
+Links
+*****
+
+Additional information related to the Windows backend:
+ http://libusb.org/wiki/windows_backend
+
+Latest Windows Driver (Development) Kit (DDK):
+ http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=36a2630f-5d56-43b5-b996-7633f2ec14ff
+
+Latest Microsoft Windows SDK:
+ http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=c17ba869-9671-4330-a63e-1fd44e0e2505