- documentation fixes (thanks to Uwe Hermann)
authordrath <drath@b42882b7-edfa-0310-969c-e2dbd0fdcd60>
Thu, 26 Jul 2007 09:34:49 +0000 (09:34 +0000)
committerdrath <drath@b42882b7-edfa-0310-969c-e2dbd0fdcd60>
Thu, 26 Jul 2007 09:34:49 +0000 (09:34 +0000)
- bootstrapping changes to accomodate packaging (thanks to Uwe Hermann)

git-svn-id: svn://svn.berlios.de/openocd/trunk@182 b42882b7-edfa-0310-969c-e2dbd0fdcd60

README
bootstrap
doc/openocd.1
src/openocd.c

diff --git a/README b/README
index 2defb5d..f5db021 100644 (file)
--- 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
 
index f7c4c0f..9fd3866 100755 (executable)
--- a/bootstrap
+++ b/bootstrap
@@ -1,4 +1,4 @@
 aclocal \
 && autoheader \
-&& automake --gnu --add-missing \
+&& automake --foreign --add-missing --copy \
 && autoconf
index d313530..b747c6d 100644 (file)
@@ -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 <filename>] [\fB\-\-debug\fR <debuglevel>] [\fB\-\-log_output\fR <filename>] [\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 <filename>"
@@ -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 <Dominic.Rath@gmx.de>
 .br 
index 600225b..b20ffd2 100644 (file)
@@ -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"