You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.Windows 2.3 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  1. Building OpenOCD for Windows
  2. ----------------------------
  3. You can build OpenOCD for Windows natively with either MinGW-w64/MSYS
  4. or Cygwin (plain MinGW might work with --disable-werror but is not
  5. recommended as it doesn't provide enough C99 compatibility).
  6. Alternatively, one can cross-compile it using MinGW-w64 on a *nix
  7. host. See README for the generic instructions.
  8. Also, the MSYS2 project provides both ready-made binaries and an easy
  9. way to self-compile from their software repository out of the box.
  10. Native MinGW-w64/MSYS compilation
  11. -----------------------------
  12. As MSYS doesn't come with pkg-config pre-installed, you need to add it
  13. manually. The easiest way to do that is to download pkg-config-lite
  14. from:
  15. http://sourceforge.net/projects/pkgconfiglite/
  16. Then simply unzip the archive to the root directory of your MinGW-w64
  17. installation.
  18. USB adapters
  19. ------------
  20. For the adapters that use a HID-based protocol, e.g. CMSIS-DAP, you do
  21. not need to perform any additional configuration.
  22. For all the others you usually need to have WinUSB.sys (or
  23. libusbK.sys) driver installed. Some vendor software (e.g. for
  24. ST-LINKv2) does it on its own. For the other cases the easiest way to
  25. assign WinUSB to a device is to use the latest Zadig installer:
  26. http://zadig.akeo.ie
  27. When using a composite USB device, it's often necessary to assign
  28. WinUSB.sys to the composite parent instead of the specific
  29. interface. To do that one needs to activate an advanced option in the
  30. Zadig installer.
  31. For the old drivers that use libusb-0.1 API you might need to link
  32. against libusb-win32 headers and install the corresponding driver with
  33. Zadig.
  34. If you need to use the same adapter with other applications that may
  35. require another driver, a solution for Windows Vista and above is to
  36. activate the IgnoreHWSerNum registry setting for the USB device.
  37. That setting forces Windows to associate the driver per port instead of
  38. per serial number, the same behaviour as when the device does not contain
  39. a serial number. So different drivers can be installed for the adapter on
  40. different ports and you just need to plug the adapter into the correct
  41. port depending on which application to use.
  42. For more information, see:
  43. http://msdn.microsoft.com/en-us/library/windows/hardware/jj649944(v=vs.85).aspx
  44. http://www.ftdichip.com/Support/Knowledgebase/index.html?ignorehardwareserialnumber.htm