Browse Source

- 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
tags/v0.1.0
drath 16 years ago
parent
commit
df4b030df7
4 changed files with 54 additions and 17 deletions
  1. +33
    -6
      README
  2. +1
    -1
      bootstrap
  3. +19
    -9
      doc/openocd.1
  4. +1
    -1
      src/openocd.c

+ 33
- 6
README View File

@@ -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
- 1
bootstrap View File

@@ -1,4 +1,4 @@
aclocal \ aclocal \
&& autoheader \ && autoheader \
&& automake --gnu --add-missing \
&& automake --foreign --add-missing --copy \
&& autoconf && autoconf

+ 19
- 9
doc/openocd.1 View File

@@ -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


+ 1
- 1
src/openocd.c View File

@@ -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"


Loading…
Cancel
Save