From: drath Date: Thu, 26 Jul 2007 09:34:49 +0000 (+0000) Subject: - documentation fixes (thanks to Uwe Hermann) X-Git-Tag: v0.1.0~1097 X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=commitdiff_plain;h=df4b030df770e905aae573b4825d62b3efc96515 - documentation fixes (thanks to Uwe Hermann) - bootstrapping changes to accomodate packaging (thanks to Uwe Hermann) git-svn-id: svn://svn.berlios.de/openocd/trunk@182 b42882b7-edfa-0310-969c-e2dbd0fdcd60 --- diff --git a/README b/README index 2defb5d1ec..f5db0218be 100644 --- a/README +++ b/README @@ -13,7 +13,7 @@ User interaction is realized through a telnet command line interface and a gdb 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, 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. 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 dongle, a parallel port interface based on a Xilinx CoolRunner CPLD. It uses 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 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 library (www.ftdichip.com) or using an open-source replacement from 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 - ARM926ej-s - ARM966e +- Cortex-M3 Support for Intel XScale CPUs is also included: - PXA25x +- PXA27x - IXP42x -PXA27x debugging should be similar to the PXA25x but fails in the current -version of OpenOCD. - 3. Host platforms 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 diff --git a/bootstrap b/bootstrap index f7c4c0facd..9fd3866e19 100755 --- a/bootstrap +++ b/bootstrap @@ -1,4 +1,4 @@ aclocal \ && autoheader \ -&& automake --gnu --add-missing \ +&& automake --foreign --add-missing --copy \ && autoconf diff --git a/doc/openocd.1 b/doc/openocd.1 index d3135300dd..b747c6d0a0 100644 --- a/doc/openocd.1 +++ b/doc/openocd.1 @@ -1,7 +1,7 @@ -.TH "OPENOCD" "1" "May 03, 2007" "" "" +.TH "OPENOCD" "1" "July 26, 2007" "" "" .SH "NAME" 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" .B openocd \fR[\fB\-fdlh\fR] [\fB\-\-file\fR ] [\fB\-\-debug\fR ] [\fB\-\-log_output\fR ] [\fB\-\-help] .SH "DESCRIPTION" @@ -10,14 +10,20 @@ is an on\-chip debugging, in\-system programming and boundary\-scan testing tool for ARM systems. .PP 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. .PP User interaction is realized through a telnet command line interface and a gdb (the GNU debugger) remote protocol server. .PP 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 * FTDI FT2232 based USB devices * USBJTAG @@ -26,7 +32,12 @@ OpenOCD supports various different types of JTAG interfaces/programmers: * Amontec JTAGkey\-Tiny * Olimex ARM\-USB\-OCD * eVerve Signalyzer - * ... other FT2232 based dongles + * American Microsystem M5960 + * Turtelizer 2 + * Hitex STR9-comSTICK + * Luminary Micro evb_lm3s811 + * ASIX PRESTO + * usbprog .PP It also supports a number of different ARM7/9 cores: * ARM7TDMI(\-s) @@ -36,13 +47,12 @@ It also supports a number of different ARM7/9 cores: * ARM922t * ARM926ej\-s * ARM966e + * Cortex-M3 .PP Support for Intel XScale CPUs is also included: * PXA25x + * PXA27x * IXP42x - -PXA27x debugging should be similar to the PXA25x but fails in the current -version of OpenOCD. .SH "OPTIONS" .TP .B "\-f, \-\-file " @@ -87,7 +97,7 @@ or on the mailing list is covered by the GNU General Public License (GPL), version 2 or later. .\" .SH "SEE ALSO" - +.BR jtag (1) .SH "AUTHORS" Dominic Rath .br diff --git a/src/openocd.c b/src/openocd.c index 600225b954..b20ffd23c8 100644 --- a/src/openocd.c +++ b/src/openocd.c @@ -18,7 +18,7 @@ * 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 #include "config.h"