summaryrefslogtreecommitdiff
path: root/_README.txt
blob: 4a2f614f1936ea2fed94c36db459d6765ef6ddeb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
              libusb 1.0 Windows binary snapshot - README

   *********************************************************************
   *  The latest version of this snapshot can always be downloaded at: *
   *  http://libusb.org/wiki/windows_backend#LatestBinarySnapshots     *
   *********************************************************************

o Visual Studio:
  - Open existing or create a new project for your application
  - Copy the libusb.h and (if not using Visual Studio 2010) stdint.h into your
    project and make sure that the location where the file(s) reside appears in
    the 'Additional Include Directories' section (Configuration Properties ->
    C/C++ -> General).
    The stdint.h file is located in the additional_includes\ directory.
  - Copy the relevant .lib file from MS32\ or MS64\ and add 'libusb-1.0.lib' to
    your 'Additional Dependencies' (Configuration Properties -> Linker -> Input)
    Also make sure that the directory where libusb-1.0.lib resides is added to
    'Additional Library Directories' (Configuration Properties -> Linker
    -> General)
  - If you use the static version of the libusb-1.0 library, make sure that
    'Runtime Library' is set to 'Multi-threaded DLL (/MD)' (Configuration
    Properties -> C/C++ -> Code Generation).
    NB: If your application requires /MT (Multi-threaded/libCMT), you need to
    recompile a static libusb 1.0 library from source.
  - Compile and run your application. If you use the DLL version of libusb-1.0,
    remember that you need to have a copy of the DLL either in the runtime
    directory or in system32

o WDK/DDK:
  - The following is an example of a sources files that you can use to compile
    a libusb 1.0 based console application. In this sample ..\libusb\ is the
    directory where you would have copied libusb.h, stdint.h as well as the
    relevant libusb-1.0.lib

	TARGETNAME=your_app
	TARGETTYPE=PROGRAM
	USE_MSVCRT=1
	UMTYPE=console
	INCLUDES=..\libusb;$(DDK_INC_PATH)
	TARGETLIBS=..\libusb\libusb-1.0.lib
	SOURCES=your_app.c
	
    The stdint.h file is located in the additional_includes\ directory.	

  - Note that if you plan to use libCMT instead of MSVCRT (USE_LIBCMT=1 instead
    of USE_MSVCRT=1), you will need to recompile libusb to use libCMT. This can
    easily be achieved, in the DDK environment, by running 'ddk_build /MT'

o MinGW/cygwin
  - Copy libusb.h to your default include directory and the relevant MinGW32\ or
    MinGW64\ .a file to your default library directory. Or, if you don't want to
    use the default locations, make sure that you feed the relevant -I and -L
    options to the compiler.
  - Add the '-lusb-1.0' linker option when compiling.

o Additional information:
  - The libusb 1.0 API documentation can be accessed at:
    http://libusb.sourceforge.net/api-1.0/modules.html
  - For some libusb samples (including source), please have a look in examples/
  - For additional information on the libusb 1.0 Windows backend please visit:
    http://libusb.org/wiki/windows_backend
  - The MinGW and MS generated DLLs are fully interchangeable, provided that you
    use the import libs provided or generate one from the .def also provided.
  - If you find any issue, please visit http://libusb.org/ and follow the
    instructions from the 'Support' & 'Bug and feature Requests'