- bootstrapping changes to accomodate packaging (thanks to Uwe Hermann) git-svn-id: svn://svn.berlios.de/openocd/trunk@182 b42882b7-edfa-0310-969c-e2dbd0fdcd60tags/v0.1.0
@@ -13,7 +13,7 @@ User interaction is realized through a telnet command line interface and a gdb | |||||
1. JTAG hardware | 1. JTAG hardware | ||||
Currently, OpenOCD supports three types of JTAG interfaces: | |||||
Currently, OpenOCD supports the following JTAG interfaces: | |||||
- Parallel port wigglers. These devices connect to a PC's parallel port, | - Parallel port wigglers. These devices connect to a PC's parallel port, | ||||
providing direct access to the JTAG lines. The OpenOCD contains descriptions | providing direct access to the JTAG lines. The OpenOCD contains descriptions | ||||
@@ -21,6 +21,15 @@ of a few Wiggler layouts, including the original 'Wiggler' design. Other | |||||
layouts (i.e. mapping of parallel port pins to JTAG lines) can be added easily. | layouts (i.e. mapping of parallel port pins to JTAG lines) can be added easily. | ||||
Typical Wiggler speeds are around 12kByte/s code download to an ARM7's RAM. | Typical Wiggler speeds are around 12kByte/s code download to an ARM7's RAM. | ||||
The list of supported parallel port devices includes: | |||||
* Macraigor Wiggler JTAG cable | |||||
* Gateworks GW16012 JTAG programmer | |||||
* Xilinx DLC5 JTAG parallel cable III | |||||
* Ka-Ro TRITON starterkit II JTAG cable | |||||
* Lattice parallel port JTAG cable | |||||
* ST FlashLINK programming cable | |||||
- The Amontec JTAG Accelerator. This is a configuration for Amontec's Chameleon | - The Amontec JTAG Accelerator. This is a configuration for Amontec's Chameleon | ||||
dongle, a parallel port interface based on a Xilinx CoolRunner CPLD. It uses | dongle, a parallel port interface based on a Xilinx CoolRunner CPLD. It uses | ||||
the IEEE1284 EPP parallel port specification, providing many times the | the IEEE1284 EPP parallel port specification, providing many times the | ||||
@@ -60,6 +69,25 @@ features and additional RS232 UART. | |||||
The Signalyzer offers support for a wide variety of target voltages from 1.2V to | The Signalyzer offers support for a wide variety of target voltages from 1.2V to | ||||
5.5V. A second connector provides access to a TTL level UART. | 5.5V. A second connector provides access to a TTL level UART. | ||||
* American Microsystem M5960 USB JTAG programmer. | |||||
* Turtelizer 2: http://www.ethernut.de/en/hardware/turtelizer/index.html | |||||
Another USB JTAG programmer, with freely available schematics. It supports | |||||
target voltages from 1.65V to 5.5V. | |||||
* Hitex STR9-comSTICK: http://www.ehitex.de/p_info.php?products_id=292 | |||||
A STR912FW44x microcontroller "board" with USB and JTAG functionality. | |||||
* Luminary Micro development board evb_lm3s811 JTAG interface. | |||||
* ASIX PRESTO: http://www.asix-tools.com/prg_presto.htm | |||||
The ASIX PRESTO is a USB JTAG programmer for a wide range of components, e.g. | |||||
microcontrollers, serial EEPROM and Flash memory chips, CPLDs and others. | |||||
* usbprog: http://www.embedded-projects.net/index.php?page_id=165 | |||||
The usbprog is a freely programmable USB adapter, which can (among other | |||||
things) use a firmware which turns it into a JTAG programmer/debugger. | |||||
All FT2232 based devices may be accessed using either FTDI's proprietary FTD2XX | All FT2232 based devices may be accessed using either FTDI's proprietary FTD2XX | ||||
library (www.ftdichip.com) or using an open-source replacement from | library (www.ftdichip.com) or using an open-source replacement from | ||||
http://www.intra2net.com/de/produkte/opensource/ftdi/index.php, also included | http://www.intra2net.com/de/produkte/opensource/ftdi/index.php, also included | ||||
@@ -75,20 +103,19 @@ This version of openocd supports the following ARM7/9 cores: | |||||
- ARM922t | - ARM922t | ||||
- ARM926ej-s | - ARM926ej-s | ||||
- ARM966e | - ARM966e | ||||
- Cortex-M3 | |||||
Support for Intel XScale CPUs is also included: | Support for Intel XScale CPUs is also included: | ||||
- PXA25x | - PXA25x | ||||
- PXA27x | |||||
- IXP42x | - IXP42x | ||||
PXA27x debugging should be similar to the PXA25x but fails in the current | |||||
version of OpenOCD. | |||||
3. Host platforms | 3. Host platforms | ||||
OpenOCD was originally developed on x86-Linux, but has since then been ported | OpenOCD was originally developed on x86-Linux, but has since then been ported | ||||
to run on Windows/Cygwin, native Windows with MinGW, FreeBSD, x86-64-Linux and | |||||
PowerPC OS-X. | |||||
to run on Windows/Cygwin, native Windows with MinGW, FreeBSD, IA64-Linux, | |||||
AMD64-Linux, Alpha-Linux, ARM-Linux, and PowerPC OS-X. | |||||
4. Documentation | 4. Documentation | ||||
@@ -1,4 +1,4 @@ | |||||
aclocal \ | aclocal \ | ||||
&& autoheader \ | && autoheader \ | ||||
&& automake --gnu --add-missing \ | |||||
&& automake --foreign --add-missing --copy \ | |||||
&& autoconf | && autoconf |
@@ -1,7 +1,7 @@ | |||||
.TH "OPENOCD" "1" "May 03, 2007" "" "" | |||||
.TH "OPENOCD" "1" "July 26, 2007" "" "" | |||||
.SH "NAME" | .SH "NAME" | ||||
openocd \- A free and open on\-chip debugging, in\-system programming and | openocd \- A free and open on\-chip debugging, in\-system programming and | ||||
boundary\-scan testing tool for ARM systems (currently ARM7/9 and XScale, Cortex\-M3 support to be merged) | |||||
boundary\-scan testing tool for ARM systems (currently ARM7/9, XScale, and Cortex\-M3) | |||||
.SH "SYNOPSIS" | .SH "SYNOPSIS" | ||||
.B openocd \fR[\fB\-fdlh\fR] [\fB\-\-file\fR <filename>] [\fB\-\-debug\fR <debuglevel>] [\fB\-\-log_output\fR <filename>] [\fB\-\-help] | .B openocd \fR[\fB\-fdlh\fR] [\fB\-\-file\fR <filename>] [\fB\-\-debug\fR <debuglevel>] [\fB\-\-log_output\fR <filename>] [\fB\-\-help] | ||||
.SH "DESCRIPTION" | .SH "DESCRIPTION" | ||||
@@ -10,14 +10,20 @@ is an on\-chip debugging, in\-system programming and boundary\-scan | |||||
testing tool for ARM systems. | testing tool for ARM systems. | ||||
.PP | .PP | ||||
The debugger uses an IEEE 1149\-1 compliant JTAG TAP bus master to access | The debugger uses an IEEE 1149\-1 compliant JTAG TAP bus master to access | ||||
on\-chip debug functionality available on ARM7/9 and XScale based | |||||
on\-chip debug functionality available on ARM7/9, XScale, and Cortex-M3 based | |||||
microcontrollers / system\-on\-chip solutions. | microcontrollers / system\-on\-chip solutions. | ||||
.PP | .PP | ||||
User interaction is realized through a telnet command line interface and | User interaction is realized through a telnet command line interface and | ||||
a gdb (the GNU debugger) remote protocol server. | a gdb (the GNU debugger) remote protocol server. | ||||
.PP | .PP | ||||
OpenOCD supports various different types of JTAG interfaces/programmers: | OpenOCD supports various different types of JTAG interfaces/programmers: | ||||
* Parallel port wigglers | |||||
* Parallel port wigglers, e.g. | |||||
* Macraigor Wiggler JTAG cable | |||||
* Gateworks GW16012 JTAG programmer | |||||
* Xilinx DLC5 JTAG parallel cable III | |||||
* Ka-Ro TRITON starterkit II JTAG cable | |||||
* Lattice parallel port JTAG cable | |||||
* ST FlashLINK programming cable | |||||
* Amontec JTAG Accelerator | * Amontec JTAG Accelerator | ||||
* FTDI FT2232 based USB devices | * FTDI FT2232 based USB devices | ||||
* USBJTAG | * USBJTAG | ||||
@@ -26,7 +32,12 @@ OpenOCD supports various different types of JTAG interfaces/programmers: | |||||
* Amontec JTAGkey\-Tiny | * Amontec JTAGkey\-Tiny | ||||
* Olimex ARM\-USB\-OCD | * Olimex ARM\-USB\-OCD | ||||
* eVerve Signalyzer | * eVerve Signalyzer | ||||
* ... other FT2232 based dongles | |||||
* American Microsystem M5960 | |||||
* Turtelizer 2 | |||||
* Hitex STR9-comSTICK | |||||
* Luminary Micro evb_lm3s811 | |||||
* ASIX PRESTO | |||||
* usbprog | |||||
.PP | .PP | ||||
It also supports a number of different ARM7/9 cores: | It also supports a number of different ARM7/9 cores: | ||||
* ARM7TDMI(\-s) | * ARM7TDMI(\-s) | ||||
@@ -36,13 +47,12 @@ It also supports a number of different ARM7/9 cores: | |||||
* ARM922t | * ARM922t | ||||
* ARM926ej\-s | * ARM926ej\-s | ||||
* ARM966e | * ARM966e | ||||
* Cortex-M3 | |||||
.PP | .PP | ||||
Support for Intel XScale CPUs is also included: | Support for Intel XScale CPUs is also included: | ||||
* PXA25x | * PXA25x | ||||
* PXA27x | |||||
* IXP42x | * IXP42x | ||||
PXA27x debugging should be similar to the PXA25x but fails in the current | |||||
version of OpenOCD. | |||||
.SH "OPTIONS" | .SH "OPTIONS" | ||||
.TP | .TP | ||||
.B "\-f, \-\-file <filename>" | .B "\-f, \-\-file <filename>" | ||||
@@ -87,7 +97,7 @@ or on the mailing list | |||||
is covered by the GNU General Public License (GPL), version 2 or later. | is covered by the GNU General Public License (GPL), version 2 or later. | ||||
.\" | .\" | ||||
.SH "SEE ALSO" | .SH "SEE ALSO" | ||||
.BR jtag (1) | |||||
.SH "AUTHORS" | .SH "AUTHORS" | ||||
Dominic Rath <Dominic.Rath@gmx.de> | Dominic Rath <Dominic.Rath@gmx.de> | ||||
.br | .br | ||||
@@ -18,7 +18,7 @@ | |||||
* 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * | * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. * | ||||
***************************************************************************/ | ***************************************************************************/ | ||||
#define OPENOCD_VERSION "Open On-Chip Debugger (2007-07-25 12:00 CEST)" | |||||
#define OPENOCD_VERSION "Open On-Chip Debugger (2007-07-26 11:30 CEST)" | |||||
#ifdef HAVE_CONFIG_H | #ifdef HAVE_CONFIG_H | ||||
#include "config.h" | #include "config.h" | ||||