From 9ee81db53e4367bbb90650ec6443f81429454971 Mon Sep 17 00:00:00 2001 From: Pete Batard Date: Thu, 12 Apr 2012 23:52:49 +0100 Subject: Windows: add internal binary snapshot scripts --- .private/wbs.txt | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 .private/wbs.txt (limited to '.private/wbs.txt') diff --git a/.private/wbs.txt b/.private/wbs.txt new file mode 100644 index 0000000..8738cd8 --- /dev/null +++ b/.private/wbs.txt @@ -0,0 +1,61 @@ + libusbx 1.0 Windows binary snapshot - README + + ********************************************************************* + * The latest version of this snapshot can always be downloaded at: * + * https://sourceforge.net/projects/libusbx/files/ * + ********************************************************************* + +o Visual Studio: + - Open existing or create a new project for your application + - Copy libusb.h, from the include\libusbx-1.0\ directory, into your project and + make sure that the location where the file reside appears in the 'Additional + Include Directories' section (Configuration Properties -> C/C++ -> General). + - 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 libusbx 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 libusbx 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 libusbx 1.0 based console application. In this sample ..\libusbx\ is the + directory where you would have copied libusb.h as well as the relevant + libusb-1.0.lib + + TARGETNAME=your_app + TARGETTYPE=PROGRAM + USE_MSVCRT=1 + UMTYPE=console + INCLUDES=..\libusbx;$(DDK_INC_PATH) + TARGETLIBS=..\libusbx\libusb-1.0.lib + SOURCES=your_app.c + + - Note that if you plan to use libCMT instead of MSVCRT (USE_LIBCMT=1 instead + of USE_MSVCRT=1), you will need to recompile libusbx to use libCMT. This can + easily be achieved, in the DDK environment, by running 'ddk_build /MT' + +o MinGW/cygwin + - Copy libusb.h, from include/libusbx-1.0/ to your default include directory, + and copy the MinGW32/ or MinGW64/ .a files 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 libusbx 1.0 API documentation can be accessed at: + http://libusbx.sourceforge.net/api-1.0/modules.html + - For some libusb samples (including source), please have a look in examples/ + - For additional information on the libusbx 1.0 Windows backend please visit: + https://sourceforge.net/apps/mediawiki/libusbx/index.php?title=Windows + - 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://libusbx.org/ and check the + Support section -- cgit v1.2.3