View source for Compiling OpenOCD v0.8.0 Linux

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

==Installing Packages==

You will need to install several packages to compile and run [[EmSys:OpenOCD | OpenOCD]]. Open a terminal window ('''Applications menu > Accessories > Terminal''') and type:<br /><br />

 sudo apt-get install libtool autoconf texinfo libusb-1.0-0-dev<br /><br />

If you prefer to compile libusb yourself, you can find the source at http://sourceforge.net/projects/libusb/files/libusb-1.0/.

==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 [[EmSys:OpenOCD | OpenOCD]]. Download '''libftdi-0.19.tar.gz''' from:
http://www.intra2net.com/en/developer/libftdi/download/libftdi-0.19.tar.gz 
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:<br /><br />

 cd ~/libftdi-0.19/src
 sudo cp ftdi.h /usr/include
 cd /usr/local/include
 sudo ln -s /usr/include/ftdi.h ftdi.h<br /><br />

Return to your '''libftdi-0.19''' directory and compile.<br /><br />

 cd ~/libftdi-0.19
 ./configure
 make
 sudo make install<br /><br />

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

 cd /usr/lib
 sudo ln -s /usr/local/lib/libftdi.a libftdi.a
 sudo ln -s /usr/local/lib/libftdi.la libftdi.la
 sudo ln -s /usr/local/lib/{{LIBFTDI_SO_VER}} {{LIBFTDI_SO_VER}}
 sudo ln -s /usr/local/lib/{{LIBFTDI_SO_VER}} libftdi.so
 sudo ln -s /usr/local/lib/{{LIBFTDI_SO_VER}} libftdi.so.1

==Downloading OpenOCD==

[{{OPENOCD}}/openocd-{{OPENOCD_VERNUM}}.tar.gz Download OpenOCD v{{OPENOCD_VERNUM}} source] and extract it to your '''home''' folder.

==Compiling OpenOCD==

In the terminal window, navigate to the new folder containing the [[EmSys:OpenOCD | OpenOCD]] source and compile as follows.

 cd ~/openocd-{{OPENOCD_VERNUM}}
 sudo ./configure --disable-werror --enable-ftdi --enable-stlink --enable-ti-icdi
 sudo make
 sudo make install

Navigate to '''/home/USERNAME/openocd-{{OPENOCD_VERNUM}}/src''' to find the '''openocd''' binary. You will need superuser privileges (the ''sudo'' command) to run [[EmSys:OpenOCD | OpenOCD]].

==Preparing to Run OpenOCD==

You can run openocd from '''/home/USERNAME/openocd-{{OPENOCD_VERNUM}}/src''', but you may encounter problems with configuration files. For a more in-depth discussion of these issues, see [[EmSys:OpenOCD | 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-{{OPENOCD_VERNUM}}-bin'''', and copy the '''openocd''' binary and the contents of '''/home/USERNAME/openocd-{{OPENOCD_VERNUM}}/tcl''' to the new directory. You can do this from the terminal window with the collowing commands:<br /><br />

 cd ~
 mkdir openocd-{{OPENOCD_VERNUM}}-bin
 cd ~/openocd-{{OPENOCD_VERNUM}}/tcl
 cp -r * ~/openocd-{{OPENOCD_VERNUM}}-bin
 cd ~/openocd-{{OPENOCD_VERNUM}}/src
 cp openocd ~/openocd-{{OPENOCD_VERNUM}}-bin<br /><br />

'''openocd-{{OPENOCD_VERNUM}}-bin''' should now contain the following files and subdirectories:<br /><br />

 board
 chip
 cpld
 cpu
 openocd
 interface
 target
 test
 bitsbytes.tcl
 mem_helper.tcl
 memory.tcl
 mmr_helpers.tcl<br /><br />

You can now run [[EmSys:OpenOCD | OpenOCD]] from '''/home/USERNAME/'openocd-{{OPENOCD_VERNUM}}-bin'''.

==See Also==
#[[EmSys:Running OpenOCD on Linux |Running OpenOCD on Linux]]
#[[EmSys:Accessing Devices without Sudo |Accessing Devices without sudo]]