README.OSX

   1 Building OpenOCD for OSX
   2 ------------------------
   3
   4 There are a few prerequisites you will need first:
   5
   6 - Xcode 5 (install from the AppStore)
   7 - Command Line Tools (install from Xcode 5 -> Preferences -> Downloads)
   8 - MacPorts (http://www.macports.org/install.php)
   9   or
  10 - Homebrew (http://mxcl.github.io/homebrew/)
  11
  12 libtool, automake, autoconf, pkg-config and libusb can be easily
  13 installed via MacPorts:
  14   sudo port install libtool automake autoconf pkgconfig libusb [libusb-compat]
  15 or with Homebrew:
  16   brew install libtool automake libusb [libusb-compat] [hidapi]
  17
  18 You should also specify LDFLAGS and CPPFLAGS to allow configure to use
  19 MacPorts' libraries, so run configure like this:
  20   LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include ./configure [options]
  21
  22 If you're using Homebrew, no custom flags are necessary.
  23
  24 See README for the generic building instructions.
  25
  26 If you're using a USB adapter and have a driver kext matched to it,
  27 you will need to unload it prior to running OpenOCD. E.g. with Apple
  28 driver (OS X 10.9 or later) for FTDI run:
  29   sudo kextunload -b com.apple.driver.AppleUSBFTDI
  30 for FTDI vendor driver use:
  31   sudo kextunload FTDIUSBSerialDriver.kext
  32
  33 To learn more on the topic please refer to the official libusb FAQ:
  34 https://github.com/libusb/libusb/wiki/FAQ