mirror of https://github.com/rusefi/openocd.git
- 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
This commit is contained in:
parent
290e01c62a
commit
df4b030df7
39
README
39
README
|
@ -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
|
to run on Windows/Cygwin, native Windows with MinGW, FreeBSD, IA64-Linux,
|
||||||
PowerPC OS-X.
|
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"
|
||||||
|
|
Loading…
Reference in New Issue