| Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 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: |
| hjelmn@cs.unm.edu | 1eff220 | 2014-01-08 23:50:34 +0000 | [diff] [blame] | 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. |
| Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 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 | |
| Toby Gray | 5bdea90 | 2013-01-16 02:10:31 +0000 | [diff] [blame] | 33 | If you are building for Windows CE then you will need the Windows CE Standard 5.00 SDK. |
| Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 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 |
| Toby Gray | 5bdea90 | 2013-01-16 02:10:31 +0000 | [diff] [blame] | 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. |
| Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 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 | |
| Toby Gray | 5bdea90 | 2013-01-16 02:10:31 +0000 | [diff] [blame] | 53 | For Windows CE it is necessary to install the CE USB Kernel Wrapper driver for |
| hjelmn@cs.unm.edu | 1eff220 | 2014-01-08 23:50:34 +0000 | [diff] [blame] | 54 | libusb to function on a device. |
| Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 55 | |
| 56 | Links |
| 57 | ***** |
| 58 | |
| 59 | Additional information related to the Windows backend: |
| hjelmn@cs.unm.edu | 1eff220 | 2014-01-08 23:50:34 +0000 | [diff] [blame] | 60 | http://windows.libusb.info |
| Pete Batard | 75b1cf8 | 2012-05-10 16:44:30 +0100 | [diff] [blame] | 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 |
| Toby Gray | 5bdea90 | 2013-01-16 02:10:31 +0000 | [diff] [blame] | 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 | |