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.OSX 1.7 KiB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. Building OpenOCD for OSX
  2. ------------------------
  3. There are a few prerequisites you will need first:
  4. - Xcode 5 (install from the AppStore)
  5. - Command Line Tools (install from Xcode 5 -> Preferences -> Downloads)
  6. - Gentoo Prefix (http://www.gentoo.org/proj/en/gentoo-alt/prefix/bootstrap.xml)
  7. or
  8. - Homebrew (http://mxcl.github.io/homebrew/)
  9. or
  10. - MacPorts (http://www.macports.org/install.php)
  11. With Gentoo Prefix you can build the release version or the latest
  12. devel version (-9999) the usual way described in the Gentoo
  13. documentation. Alternatively, install the prerequisites and build
  14. manually from the sources.
  15. With Homebrew you can either run:
  16. brew install [--HEAD] openocd (where optional --HEAD asks brew to
  17. install the current git version)
  18. or
  19. brew install libtool automake libusb [libusb-compat] [hidapi] [libftdi]
  20. (to install the needed dependencies and then proceed with the
  21. manual building procedure)
  22. For building with MacPorts you need to run:
  23. sudo port install libtool automake autoconf pkgconfig \
  24. libusb [libusb-compat] [libftdi1]
  25. You should also specify LDFLAGS and CPPFLAGS to allow configure to use
  26. MacPorts' libraries, so run configure like this:
  27. LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include ./configure [options]
  28. See README for the generic building instructions.
  29. If you're using a USB adapter and have a driver kext matched to it,
  30. you will need to unload it prior to running OpenOCD. E.g. with Apple
  31. driver (OS X 10.9 or later) for FTDI run:
  32. sudo kextunload -b com.apple.driver.AppleUSBFTDI
  33. for FTDI vendor driver use:
  34. sudo kextunload FTDIUSBSerialDriver.kext
  35. To learn more on the topic please refer to the official libusb FAQ:
  36. https://github.com/libusb/libusb/wiki/FAQ