blob: d36080680b8b1b711cd051f27173b5edae368c40 [file] [log] [blame]
Linus Walleija459cc12009-01-14 21:43:23 +00001This file was created by James Ravenscroft <ravenscroftj@gmail.com> as a direct revision of Farooq Zaman's work with LibMTP on Windows.
Linus Walleij7beba572006-11-29 08:56:12 +00002
Linus Walleija459cc12009-01-14 21:43:23 +00003 CHANGELOG
4----------------
514th January 2009: Created the first revision of this file taking information from the work of Farooq Zaman.
Linus Walleij7beba572006-11-29 08:56:12 +00006
Linus Walleija459cc12009-01-14 21:43:23 +00007 1.0 Compilation of LibMTP on Windows 2000/XP/NT
8-----------------------------------------------------------
9LibMTP currently compiles under Windows using MingW/MSys. The source relies upon the __WIN32__ macro which is defined by MinGW by default.
Linus Walleij7beba572006-11-29 08:56:12 +000010
Linus Walleija459cc12009-01-14 21:43:23 +000011Libraries:
12LibMTP currently depends on LibUSB and libiconv. There are currently projects that port both of these libraries to Windows. Binary files can be
13obtained from:
Linus Walleij7beba572006-11-29 08:56:12 +000014
Linus Walleija459cc12009-01-14 21:43:23 +000015LibUSB Win32 - http://libusb-win32.sourceforge.net/
Linus Walleij7beba572006-11-29 08:56:12 +000016
Linus Walleija459cc12009-01-14 21:43:23 +000017LibIconv - http://gnuwin32.sourceforge.net/packages/libiconv.htm
Linus Walleij7beba572006-11-29 08:56:12 +000018
Linus Walleija459cc12009-01-14 21:43:23 +000019With both of these libraries extracted and placed in MinGW's search path, you can compile the library by opening the Msys prompt, navigating to
20the path where the extracted LibMTP source files can be found and typing:
Linus Walleij7beba572006-11-29 08:56:12 +000021
Linus Walleija459cc12009-01-14 21:43:23 +000022./configure
23make all
24make install
Linus Walleij7beba572006-11-29 08:56:12 +000025
26
27
Linus Walleija459cc12009-01-14 21:43:23 +000028 2.0 LibUSB and Driver Issues for Windows
29----------------------------------------------
Linus Walleij7beba572006-11-29 08:56:12 +000030
Linus Walleija459cc12009-01-14 21:43:23 +000031Unfortunately, Windows does not have abstract USB support and depends upon specific drivers for each and every device you use. Fortunately,
32LibUSB-Win32 provide a solution to this problem. LibMTP takes advantage of the LibUSB-Win32 Device Driver package.
Linus Walleij7beba572006-11-29 08:56:12 +000033
Linus Walleija459cc12009-01-14 21:43:23 +0000341. Download the latest device driver binary package (libusb-win32-device-bin-x.x.x.x.tar.gz) from http://sourceforge.net/project/showfiles.php?group_id=78138
352. Upon extraction, plug in your music device and run bin/inf-wizard.exe. Selecting your device and saving the inf file in the project root directory.
363. Copy the files "bin/libusb0.dll" and "libusb0.sys" or "libusb0_x64.dll" and "libusb0_x64.sys" for 32-bit or 64-bit operating systems respectively.
374. Goto Start -> Run, type "devmgmt.msc" and press "ok".
385. Select your music device from the list and click Action -> Update Driver, Choose "No, not this time" if prompted to connect to microsoft.
396. Choose "Install from a list or specific location".
407. Choose "Don't search, I will choose the driver to install
418. Click the "Have Disk..." button in the bottom right corner of the prompt
429. Browse to your .inf file and select it. Press Ok
4310. The name of your music device should appear in the prompt, click it and click "Next>" (Ignore any prompts about Driver Signing, continuing
44installation of the selected driver).
4511. Click finish to end the driver install process.
Linus Walleij7beba572006-11-29 08:56:12 +000046
Linus Walleija459cc12009-01-14 21:43:23 +000047To get your old driver back:
Linus Walleij7beba572006-11-29 08:56:12 +000048
Linus Walleija459cc12009-01-14 21:43:23 +0000491. Goto Start -> Run, type "devmgmt.msc" and press "ok".
502. Select your music device, right click on it and click "Properties"
513. Go to the "Driver" pane and select "Roll Back Driver".
Linus Walleij7beba572006-11-29 08:56:12 +000052
Linus Walleija459cc12009-01-14 21:43:23 +000053 3.0
54----------------------------------------------