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