Template:CompileOpenOCDFedoraGit - Revision history

Wmat: Updated the OpenOCD git URL.

2012-11-16T19:28:28Z

Updated the OpenOCD git URL.

Wmat: /* Installing Packages */

2012-08-27T17:20:23Z

‎Installing Packages

Wmat: /* Downloading and Compiling libFTDI */

2012-08-27T16:31:53Z

‎Downloading and Compiling libFTDI

Wmat: adding the correct udev rules incantation for running FS2 as nonroot user on F17

2012-08-23T21:15:19Z

adding the correct udev rules incantation for running FS2 as nonroot user on F17

Wmat: /* Preparing to Run OpenOCD */

2012-08-23T19:38:20Z

‎Preparing to Run OpenOCD

Wmat: /* Compiling OpenOCD */

2012-08-23T19:31:15Z

‎Compiling OpenOCD

Wmat: /* Downloading and Compiling libFTDI */

2012-08-23T19:14:50Z

‎Downloading and Compiling libFTDI

Wmat: Updating section for Fedora

2012-08-23T19:06:03Z

Updating section for Fedora

Wmat: Switching Ubuntu to Fedora

2012-08-23T19:02:10Z

Switching Ubuntu to Fedora

Wmat: Seeding Fedora Template with content from Ubuntu Template.

2012-08-23T18:58:38Z

Seeding Fedora Template with content from Ubuntu Template.

New page

This guide will compile [[OpenOCD]] {{{3}}} for Ubuntu 10.04 with the {{{{{2}}}_NAME_CAPS}} driver library, for use with the TinCanTools Flyswatter, Flyswatter2, and Flyswatter3. Version {{{3}}} is the version of OpenOCD currently in development. For instructions on compiling with the most recent release code, see [[Compiling OpenOCD Linux]].

==OpenOCD 0.6.0 vs the 0.5.0 Release==

This guide uses the most recent version of the OpenOCD source currently in development. Unlike the 0.5.0 release the development version includes support for the Flyswatter2 and Flyswatter3, so you won't need to download or apply a patch before compiling. However, the development code is subject to change at any time. If you encounter problems with this option, try the OpenOCD 0.5.0 instructions in [[Compiling OpenOCD Linux]] instead.

==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 http://sourceforge.net/projects/libusb/files/libusb-1.0/.

==Downloading and Compiling libFTDI==

libFTDI is an open source library that enables you to talk to FTDI chips like: FT232BM, FT245BM, FT245R, FT2232C, FT2232D and FT2232H. You will need libFTDI to compile [[OpenOCD]]. Download '''libftdi-{{{{{2}}}_VERNUM}}.tar.gz''' from:
http://www.intra2net.com/en/developer/libftdi/download.php
and extract it to your home directory ('''/home/USERNAME''', replacing USERNAME with your username).

Navigate to '''home/USERNAME/libftdi-{{{{{2}}}_VERNUM}}/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-{{{{{2}}}_VERNUM}}/src
sudo cp ftdi.h /usr/include
cd /usr/local/include
sudo ln -s /usr/include/ftdi.h ftdi.h

Return to your '''libftdi-{{{{{2}}}_VERNUM}}''' directory and compile.

cd ~/libftdi-{{{{{2}}}_VERNUM}}
./configure
make
sudo 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/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==

Git is version control software distributed with Ubuntu. You can use git to download the current development code from the OpenOCD git repository at sourceforge.net. In the terminal window, navigate to your home directory and make sure you don't already have a directory there named '''openocd/'''. (Downloading with git will create a directory called '''openocd/''' containing the OpenOCD source. If you already have a directory called '''openocd/''' either rename it or navigate to a different directory before you proceed.) Then download OpenOCD with the following command:

cd ~
git clone git://openocd.git.sourceforge.net/gitroot/openocd/openocd

There should now be a folder in your home directory called '''openocd/.'''

==Compiling OpenOCD==

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

cd ~/openocd
sudo ./bootstrap
sudo ./configure --enable-maintainer-mode --disable-werror --enable-ft2232_libftdi
sudo make
sudo make install

Navigate to '''/home/USERNAME/openocd/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/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-bin
cd ~/openocd/tcl
cp -r * ~/openocd-bin
cd ~/openocd/src
cp openocd ~/openocd-bin

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

board
chip
cpld
cpu
openocd
interface
target
test
bitsbytes.tcl
mem_helper.tcl
memory.tcl
mmr_helpers.tcl

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

[[Category:TinCanTools]]
[[Category:OpenOCD]]
[[Category:Fedora]]

@@ Line 19: / Line 19: @@
 You will need to install several packages to compile and run [[OpenOCD]]. Open a terminal window ('''Applications menu > Terminal Emulator''') and type:
-  sudo yum install libtool autoconf texinfo libusb-dev
+  sudo yum install git libtool autoconf texinfo libusb-dev
 If you prefer to compile libusb yourself, you can find the source at http://sourceforge.net/projects/libusb/files/libusb-1.0/.

@@ Line 29: / Line 29: @@
 Fedora 17 provides libftdi-0.19.  To install:
-$ sudo yum install libftdi
+ $ sudo yum install libftdi
 ==Downloading OpenOCD==

← Older revision		Revision as of 21:15, 23 August 2012
Line 86:		Line 86:
	mmr_helpers.tcl		mmr_helpers.tcl

		+	===Set udev rules to allow non-root running of OpenOCD===
		+
		+	$cd /etc/udev/rules.d
		+	$sudo vim 45-flyswatter2.rules
		+	Paste the following lines:
		+	SUBSYSTEM=="usb", ACTION=="add", ENV{DEVTYPE}=="usb_device", \
		+	ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6010", GROUP="wheel", MODE="0666"
		+
		+	NOTE that I used the wheel group, as I know my user is a member. You can also omit the GROUP variable and add OWNER="<username>" where <username> is your username.
		+
		+	Be sure to unplug you Flyswatter2 from your PC at this point, before reloading the udev rules as changes only apply to new events.
		+
		+	$sudo udevadm control --reload
		+
		+	Now plug your Flyswatter2 back in and proceed to running OpenOCD as a non-root user.
	You can now run [[OpenOCD]] from '''/home/USERNAME/openocd-bin'''. To get started running OpenOCD, see [[Running OpenOCD on Linux]].		You can now run [[OpenOCD]] from '''/home/USERNAME/openocd-bin'''. To get started running OpenOCD, see [[Running OpenOCD on Linux]].

@@ Line 36: / Line 36: @@
   cd ~
-  git clone git://openocd.git.sourceforge.net/gitroot/openocd/openocd
+  git clone git://git.code.sf.net/p/openocd/code
 There should now be a folder in your home directory called '''openocd/.'''
 ==Compiling OpenOCD==

@@ Line 68: / Line 68: @@
   cd ~/openocd/tcl
   cp -r * ~/openocd-bin
-  cd ~/openocd/src
+  cd ../src
   cp openocd ~/openocd-bin

@@ Line 46: / Line 46: @@
   cd ~/openocd
-  sudo ./bootstrap
+  ./bootstrap
-  sudo ./configure --enable-maintainer-mode --disable-werror --enable-ft2232_libftdi
+  ./configure --enable-maintainer-mode --disable-werror --enable-ftdi
-  sudo make
+  make
- sudo make install
-Navigate to '''/home/USERNAME/openocd/src''' to find the '''openocd''' binary. You will need superuser privileges (the ''sudo'' command) to run [[OpenOCD]].
+At this point you can continue and do:
 ==Preparing to Run OpenOCD==

@@ Line 25: / Line 25: @@
 ==Downloading and Compiling libFTDI==
-libFTDI is an open source library that enables you to talk to FTDI chips like: FT232BM, FT245BM, FT245R, FT2232C, FT2232D and FT2232H. You will need libFTDI to compile [[OpenOCD]]. Download '''libftdi-{{{{{2}}}_VERNUM}}.tar.gz''' from:
+libFTDI is an open source library that enables you to talk to FTDI chips like: FT232BM, FT245BM, FT245R, FT2232C, FT2232D and FT2232H. You will need libFTDI to compile [[OpenOCD]].
-http://www.intra2net.com/en/developer/libftdi/download.php
-and extract it to your home directory ('''/home/USERNAME''', replacing USERNAME with your username).
-Navigate to '''home/USERNAME/libftdi-{{{{{2}}}_VERNUM}}/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:
+Fedora 17 provides libftdi-0.19.  To install:
-−
-  cd ~/libftdi-{{{{{2}}}_VERNUM}}/src
- sudo cp ftdi.h /usr/include
- cd /usr/local/include
- sudo ln -s /usr/include/ftdi.h ftdi.h
-−
-Return to your '''libftdi-{{{{{2}}}_VERNUM}}''' directory and compile.
-−
- cd ~/libftdi-{{{{{2}}}_VERNUM}}
- ./configure
- make
- sudo 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/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==

@@ Line 7: / Line 7: @@
 -->
-This guide will compile [[OpenOCD]] {{{3}}} for Ubuntu 10.04 with the {{{{{2}}}_NAME_CAPS}} driver library, for use with the TinCanTools Flyswatter, Flyswatter2, and Flyswatter3. Version {{{3}}} is the version of OpenOCD currently in development. For instructions on compiling with the most recent release code, see [[Compiling OpenOCD Linux]].
+This guide will compile [[OpenOCD]] {{{3}}} for Fedora 17 with the {{{{{2}}}_NAME_CAPS}} driver library, for use with the TinCanTools Flyswatter and Flyswatter2. Version {{{3}}} is the version of OpenOCD currently in development. For instructions on compiling with the most recent release code, see [[Compiling OpenOCD Linux]].
 ==OpenOCD 0.6.0 vs the 0.5.0 Release==
-This guide uses the most recent version of the OpenOCD source currently in development. Unlike the 0.5.0 release the development version includes support for the Flyswatter2 and Flyswatter3, so you won't need to download or apply a patch before compiling. However, the development code is subject to change at any time. If you encounter problems with this option, try the OpenOCD 0.5.0 instructions in [[Compiling OpenOCD Linux]] instead.
+This guide uses the most recent version of the OpenOCD source currently in development. Unlike the 0.5.0 release the development version includes support for the Flyswatter2, so you won't need to download or apply a patch before compiling. However, the development code is subject to change at any time. If you encounter problems with this option, try the OpenOCD 0.5.0 instructions in [[Compiling OpenOCD Linux]] instead.
@@ Line 56: / Line 56: @@
 ==Downloading OpenOCD==
-Git is version control software distributed with Ubuntu. You can use git to download the current development code from the OpenOCD git repository at sourceforge.net. In the terminal window, navigate to your home directory and make sure you don't already have a directory there named '''openocd/'''. (Downloading with git will create a directory called '''openocd/''' containing the OpenOCD source. If you already have a directory called '''openocd/''' either rename it or navigate to a different directory before you proceed.) Then download OpenOCD with the following command:
+Git is version control software distributed with Fedora. You can use git to download the current development code from the OpenOCD git repository at sourceforge.net. In the terminal window, navigate to your home directory and make sure you don't already have a directory there named '''openocd/'''. (Downloading with git will create a directory called '''openocd/''' containing the OpenOCD source. If you already have a directory called '''openocd/''' either rename it or navigate to a different directory before you proceed.) Then download OpenOCD with the following command:
   cd ~