68e50415a1
Now that the old drivers have been converted to libusb1, there is no need to keep the build dependency from libusb0. Drop libusb0 from configure and makefiles, remove the libusb0 helper and remove libusb0 and libusb-compat from the README files. Change-Id: Icc05be74ae5971ba6cbb67d39107c709a4d826e6 Signed-off-by: Antonio Borneo <borneo.antonio@gmail.com> Reviewed-on: http://openocd.zylin.com/5993 Tested-by: jenkins
57 lines
2.2 KiB
Plaintext
57 lines
2.2 KiB
Plaintext
Building OpenOCD for Windows
|
|
----------------------------
|
|
|
|
You can build OpenOCD for Windows natively with either MinGW-w64/MSYS
|
|
or Cygwin (plain MinGW might work with --disable-werror but is not
|
|
recommended as it doesn't provide enough C99 compatibility).
|
|
Alternatively, one can cross-compile it using MinGW-w64 on a *nix
|
|
host. See README for the generic instructions.
|
|
|
|
Also, the MSYS2 project provides both ready-made binaries and an easy
|
|
way to self-compile from their software repository out of the box.
|
|
|
|
Native MinGW-w64/MSYS compilation
|
|
-----------------------------
|
|
|
|
As MSYS doesn't come with pkg-config pre-installed, you need to add it
|
|
manually. The easiest way to do that is to download pkg-config-lite
|
|
from:
|
|
|
|
http://sourceforge.net/projects/pkgconfiglite/
|
|
|
|
Then simply unzip the archive to the root directory of your MinGW-w64
|
|
installation.
|
|
|
|
USB adapters
|
|
------------
|
|
|
|
For the adapters that use a HID-based protocol, e.g. CMSIS-DAP, you do
|
|
not need to perform any additional configuration.
|
|
|
|
For all the others you usually need to have WinUSB.sys (or
|
|
libusbK.sys) driver installed. Some vendor software (e.g. for
|
|
ST-LINKv2) does it on its own. For the other cases the easiest way to
|
|
assign WinUSB to a device is to use the latest Zadig installer:
|
|
|
|
http://zadig.akeo.ie
|
|
|
|
When using a composite USB device, it's often necessary to assign
|
|
WinUSB.sys to the composite parent instead of the specific
|
|
interface. To do that one needs to activate an advanced option in the
|
|
Zadig installer.
|
|
|
|
If you need to use the same adapter with other applications that may
|
|
require another driver, a solution for Windows Vista and above is to
|
|
activate the IgnoreHWSerNum registry setting for the USB device.
|
|
|
|
That setting forces Windows to associate the driver per port instead of
|
|
per serial number, the same behaviour as when the device does not contain
|
|
a serial number. So different drivers can be installed for the adapter on
|
|
different ports and you just need to plug the adapter into the correct
|
|
port depending on which application to use.
|
|
|
|
For more information, see:
|
|
|
|
http://msdn.microsoft.com/en-us/library/windows/hardware/jj649944(v=vs.85).aspx
|
|
http://www.ftdichip.com/Support/Knowledgebase/index.html?ignorehardwareserialnumber.htm
|