diff options
author | Paul Fertser <fercerpav@gmail.com> | 2021-01-23 13:54:04 +0300 |
---|---|---|
committer | Paul Fertser <fercerpav@gmail.com> | 2021-01-24 19:31:24 +0000 |
commit | 047df630187bf5d54731aeaada33c639c57daf66 (patch) | |
tree | a96e619d6a191bd7d88178a28cbf2aafcde3be69 /README.macOS | |
parent | bd1adcffe7f3e51f490bf57889e7454816661196 (diff) | |
download | riscv-openocd-047df630187bf5d54731aeaada33c639c57daf66.zip riscv-openocd-047df630187bf5d54731aeaada33c639c57daf66.tar.gz riscv-openocd-047df630187bf5d54731aeaada33c639c57daf66.tar.bz2 |
README.macOS: explain how to install suitable Texinfo
Change-Id: Ic5906111f412eebd906a9be3fd0e133484def3eb
Signed-off-by: Paul Fertser <fercerpav@gmail.com>
Reviewed-on: http://openocd.zylin.com/6026
Tested-by: jenkins
Reviewed-by: Antonio Borneo <borneo.antonio@gmail.com>
Diffstat (limited to 'README.macOS')
-rw-r--r-- | README.macOS | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/README.macOS b/README.macOS new file mode 100644 index 0000000..c532e67 --- /dev/null +++ b/README.macOS @@ -0,0 +1,54 @@ +Building OpenOCD for macOS +-------------------------- + +There are a few prerequisites you will need first: + +- Xcode (install from the AppStore) +- Command Line Tools (install from Xcode -> Preferences -> Downloads) +- Gentoo Prefix (http://www.gentoo.org/proj/en/gentoo-alt/prefix/bootstrap.xml) + or +- Homebrew (http://mxcl.github.io/homebrew/) + or +- MacPorts (http://www.macports.org/install.php) + + +If you're building manually you need Texinfo version 5.0 or later. The +simplest way to get it is to use Homebrew (brew install texinfo) and +then ``export PATH=/usr/local/opt/texinfo/bin:$PATH``. + + +With Gentoo Prefix you can build the release version or the latest +devel version (-9999) the usual way described in the Gentoo +documentation. Alternatively, install the prerequisites and build +manually from the sources. + + +With Homebrew you can either run: + brew install [--HEAD] openocd (where optional --HEAD asks brew to + install the current git version) + or + brew install libtool automake libusb [libusb-compat] [hidapi] [libftdi] + (to install the needed dependencies and then proceed with the + manual building procedure) + + +For building with MacPorts you need to run: + sudo port install libtool automake autoconf pkgconfig \ + libusb [libusb-compat] [libftdi1] + +You should also specify LDFLAGS and CPPFLAGS to allow configure to use +MacPorts' libraries, so run configure like this: + LDFLAGS=-L/opt/local/lib CPPFLAGS=-I/opt/local/include ./configure [options] + + +See README for the generic building instructions. + +If you're using a USB adapter and have a driver kext matched to it, +you will need to unload it prior to running OpenOCD. E.g. with Apple +driver (OS X 10.9 or later) for FTDI run: + sudo kextunload -b com.apple.driver.AppleUSBFTDI +for FTDI vendor driver use: + sudo kextunload FTDIUSBSerialDriver.kext + +To learn more on the topic please refer to the official libusb FAQ: +https://github.com/libusb/libusb/wiki/FAQ |