- prepare OpenOCD for branching, created ./trunk/
[openocd.git] / README
1                                     openocd
2
3              Free and Open On-Chip Debugging, In-System Programming 
4                            and Boundary-Scan Testing
5                      Copyright (c) 2004, 2005 Dominic Rath
6
7 The debugger uses an IEEE 1149-1 compliant JTAG TAP bus master to access on-chip
8 debug functionality available on ARM7 and ARM9 based microcontrollers /
9 system-on-chip solutions.
10
11 User interaction is realized through a telnet command line interface and a gdb
12 (The GNU Debugger) remote protocol server.
13
14 Initially, support for two JTAG TAP bus master interfaces with public hardware
15 schematics will be included, but support of additional hardware is an expressed
16 goal.
17
18 1. JTAG hardware
19
20 Currently, openocd contains support for Wiggler-compatible paralell port
21 dongles and a USB interface based on the FTDI FT2232, called USBJTAG-1.
22 A new version of the USB interface, USB-JTAG v1.2, is available with complete
23 schematics (http://www.fh-augsburg.de/~hhoegl/proj/volksmikro/usb-jtag/050910/).
24
25 It was tested using Amontec's (www.amontec.com) Chameleon POD in it's
26 Wiggler configuration, but homemade wigglers should work just as well.
27 In order to use the reset functionality (warm-reset, debug from reset, reset
28 and init), the choosen Wiggler has to connect the nSRST line.
29
30 USBJTAG-1 is based on a FTDI DLP2232M module and a few additional parts.
31 Schematics are freely available. USB-JTAG v1.2 doesn't use the DLP2232M, but
32 has the FTDI chip soldered directly on the PCB. There are two drivers for these
33 modules implemented, one using the open source libftdi, the other using FTDI's
34 proprietary FTD2XX library.
35
36 2. Supported cores
37
38 This version of openocd supports the following cores:
39
40 - ARM7TDMI
41 - ARM9TDMI
42
43 Support for cores with MMUs (ARM720t, ARM920t) is currently being merged.
44
45 3. Licensing
46
47 openocd is licensed under the terms of the GNU General Public License, see the
48 file COPYING for details.
49