Compiling OpenOCD v07 Linux

This guide will compile OpenOCD version 0.7.0 for use on Ubuntu 12.04 LTS with the open source LibFTDI driver library, for use with the TinCanTools Flyswatter2 and Flyswatter. This is the most recent release version of OpenOCD.

Installing Packages

You will need to install several packages to compile and run OpenOCD. Open a terminal window (Applications menu > Accessories > Terminal) and type:

sudo apt-get install libtool autoconf texinfo libusb-dev

If you prefer to compile libusb yourself, you can find the source at

Downloading and Compiling libFTDI

libFTDI is an open source library that enables you to communicate with FTDI chips like: FT232BM, FT245BM, FT245R, FT2232C, FT2232D and FT2232H. You will need libFTDI to compile OpenOCD. Download libftdi-0.19.tar.gz from: and extract it to your home directory (/home/USERNAME, replacing USERNAME with your username).

Navigate to home/USERNAME/libftdi-0.19/src, and copy ftdi.h to your /usr/include directory. Then create a symbolic link to ftdi.h in /usr/local/include. In the terminal window:

cd ~/libftdi-0.19/srcsudo cp ftdi.h /usr/includecd /usr/local/includesudo ln -s /usr/include/ftdi.h ftdi.h

Return to your libftdi-0.19 directory and compile.

cd ~/libftdi-0.19./configuremakesudo make install

This will install the necessary library files to /usr/local/lib. Navigate to /usr/lib and create symbolic links to the new files.

cd /usr/libsudo ln -s /usr/local/lib/libftdi.a libftdi.asudo ln -s /usr/local/lib/ libftdi.lasudo ln -s /usr/local/lib/ ln -s /usr/local/lib/ libftdi.sosudo ln -s /usr/local/lib/

Downloading OpenOCD

Download the OpenOCD v0.70 source from:

and extract it to /home/USERNAME/openocd-0.7.0. (replacing USERNAME with your username).

Compiling OpenOCD

In the terminal window, navigate to the new folder containing the OpenOCD source and compile as follows.

cd ~/openocd-0.7.0sudo ./configure --disable-werror --enable-ft2232_libftdisudo makesudo make install

Navigate to /home/USERNAME/openocd-0.7.0/src to find the openocd binary. You will need superuser privileges (the sudo command) to run OpenOCD.

Preparing to Run OpenOCD

You can run openocd from /home/USERNAME/openocd-0.7.0/src, but you may encounter problems with configuration files. For a more in-depth discussion of these issues, see OpenOCD Config File Paths. This guide recommends that you create a new directory containing OpenOCD and its config files.

Create a new directory in /home/USERNAME called openocd-bin, and copy the openocd binary and the contents of /home/USERNAME/openocd/tcl to the new directory. You can do this from the terminal window with the collowing commands:

cd ~mkdir openocd-bincd ~/openocd-0.7.0/tclcp -r * ~/openocd-bincd ~/openocd-0.7.0/srccp openocd ~/openocd-bin

openocd-bin should now contain the following files and subdirectories:


You can now run OpenOCD from /home/USERNAME/openocd-bin. To get started running OpenOCD, see Running OpenOCD on Linux.

Leave a Reply

Your email address will not be published. Required fields are marked *