Home | History | Annotate | Download | only in libusb
      1 Installation Instructions for Windows
      2 *************************************
      3 
      4 If you are compiling for MinGW or cygwin, please refer to the INSTALL file.
      5 
      6 If you are using Microsoft Visual Studio:
      7 - Open the relevant solution file in /msvc:
      8   libusb.dsw for MSVC6, libusb_2005.sln for Visual Studio 2005 or 2008,
      9   libusb_2010.sln for Visual Studio 2010,
     10   libusb_2012.sln for Visual Studio 2012 or later,
     11   libusb_wince.sln for Windows CE support in Visual Studio 2005.
     12 - If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
     13   in msvc\config.h
     14 - Select your configuration and compile the project
     15 
     16 Note that if you are using Visual Studio Express, you may have to install the
     17 Windows SDK to be able to compile the 64 bit version of the library.
     18 
     19 If you are using the freely available Windows DDK/WDK (Driver Development Kit)
     20 - If you want to debug the library, uncomment the ENABLE_DEBUG_LOGGING define
     21   in msvc\config.h
     22 - Open one of the relevant Free Build or Checked Build prompt for your target
     23   platform
     24 - Navigate to the msvc\ directory where the ddk_build.cmd file is located, and
     25   run 'ddk_build'
     26 - To produce a DLL rather than a static library, use: 'ddk_build DLL'
     27 - To produce a static library that uses LIBCMT[d] instead of MSVCRT[d] (/MT[d]
     28   vs /MD[d] in Visual Studio) use: 'ddk_build /MT'
     29 
     30 Note that using the Windows DDK, it is possible to compile both the 32 and 64
     31 bit versions of the library.
     32 
     33 If you are building for Windows CE then you will need the Windows CE Standard 5.00 SDK.
     34 
     35 Destination directories
     36 ***********************
     37 
     38 The 32 bit binaries compiled either from Visual Studio or the DDK are placed in
     39 a Win32\ directory at the root of the library
     40 The 64 bit binaries are placed in an x64\ directory
     41 Windows CE binaries are placed in one of the following directories, depending
     42 on the target processor: ARMV4I, MIPSII, MIPSII_FP, MIPSIV, MIPSIV_FP, SH4 or x86.
     43 
     44 
     45 Troubleshooting
     46 ***************
     47 
     48 If the compilation process complains about missing libraries, ensure that the
     49 default library paths for your project points to the relevant directories.
     50 If needed, these libraries can be obtained by installing either the latest
     51 Windows SDK or the DDK (Links provided at the end of this file).
     52 
     53 For Windows CE it is necessary to install the CE USB Kernel Wrapper driver for
     54 libusb to function on a device.
     55 
     56 Links
     57 *****
     58 
     59 Additional information related to the Windows backend:
     60   http://windows.libusb.info
     61 
     62 Latest Windows Driver (Development) Kit (WDK):
     63   http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=36a2630f-5d56-43b5-b996-7633f2ec14ff
     64 
     65 Latest Microsoft Windows SDK:
     66   http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=c17ba869-9671-4330-a63e-1fd44e0e2505
     67 
     68 Windows CE Standard 5.00 SDK:
     69   http://www.microsoft.com/en-gb/download/details.aspx?id=17310
     70 
     71 Windows CE USB Kernel Wrapper Driver:
     72   https://github.com/RealVNC/CEUSBKWrapper
     73 
     74