You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README 5.0 KiB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129
  1. OpenOCD
  2. Free and Open On-Chip Debugging, In-System Programming
  3. and Boundary-Scan Testing
  4. Copyright (c) 2004-2007 Dominic Rath
  5. The debugger uses an IEEE 1149-1 compliant JTAG TAP bus master to access on-chip
  6. debug functionality available on ARM7 and ARM9 based microcontrollers /
  7. system-on-chip solutions.
  8. User interaction is realized through a telnet command line interface and a gdb
  9. (The GNU Debugger) remote protocol server.
  10. 1. JTAG hardware
  11. Currently, OpenOCD supports the following JTAG interfaces:
  12. - Parallel port wigglers. These devices connect to a PC's parallel port,
  13. providing direct access to the JTAG lines. The OpenOCD contains descriptions
  14. of a few Wiggler layouts, including the original 'Wiggler' design. Other
  15. layouts (i.e. mapping of parallel port pins to JTAG lines) can be added easily.
  16. Typical Wiggler speeds are around 12kByte/s code download to an ARM7's RAM.
  17. The list of supported parallel port devices includes:
  18. * Macraigor Wiggler JTAG cable
  19. * Gateworks GW16012 JTAG programmer
  20. * Xilinx DLC5 JTAG parallel cable III
  21. * Ka-Ro TRITON starterkit II JTAG cable
  22. * Lattice parallel port JTAG cable
  23. * ST FlashLINK programming cable
  24. - The Amontec JTAG Accelerator. This is a configuration for Amontec's Chameleon
  25. dongle, a parallel port interface based on a Xilinx CoolRunner CPLD. It uses
  26. the IEEE1284 EPP parallel port specification, providing many times the
  27. performance achievable with wiggler-style devices. Additional information is
  28. available on www.amontec.com.
  29. Typical JTAG Accelerator speeds are around 120-160kByte/s to an ARM7's RAM.
  30. - FTDI FT2232 based USB devices. The FT2232 (but not FT232 or FT245) features a
  31. multi-protocol synchronous serial engine (MPSSE) that can be used to run the
  32. serial JTAG protocol. There are several implemenations of FT2232 based devices:
  33. * USBJTAG: http://www.fh-augsburg.de/~hhoegl/proj/usbjtag/usbjtag.html
  34. The USBJTAG was designed by Prof. Hubert Hoegl to provide a high-speed USB
  35. interface for use with the OpenOCD. Schematics are available at the USBJTAG
  36. website, and a homebrew device can easily be built using the FTDI evaluation
  37. module DLP2232M.
  38. * OOCD-Link: http://www.joernonline.de/dw/doku.php?id=en:projects:oocdlink
  39. Similar to the USBJTAG, this design comes with free schematics, too.
  40. * Amontec JTAGkey: www.amontec.com
  41. The Amontec JTAGkey offers support for a wide variety of target voltages from
  42. 1.4V to 5V. It also allows the JTAG lines and reset signals to be tri-stated,
  43. allowing easy interfacing with a wide variety of targets.
  44. * Amontec JTAGkey-Tiny: www.amontec.com
  45. The Amontec JTAGkey offers support for a wide variety of target voltages from
  46. 2.8V to 5V. It also allows the reset signals to be tri-stated, allowing easy
  47. interfacing with a wide variety of targets.
  48. * Olimex ARM-USB-OCD: www.olimex.com
  49. The Olimex ARM-USB-OCD offers support for a wide vriety of target voltages from
  50. 2.0V to 5V. It also allows targets to be powered from the ARM-USB-OCD and
  51. features and additional RS232 UART.
  52. * eVerve Signalyzer: www.signalyzer.com
  53. The Signalyzer offers support for a wide variety of target voltages from 1.2V to
  54. 5.5V. A second connector provides access to a TTL level UART.
  55. * American Microsystem M5960 USB JTAG programmer.
  56. * Turtelizer 2: http://www.ethernut.de/en/hardware/turtelizer/index.html
  57. Another USB JTAG programmer, with freely available schematics. It supports
  58. target voltages from 1.65V to 5.5V.
  59. * Hitex STR9-comSTICK: http://www.ehitex.de/p_info.php?products_id=292
  60. A STR912FW44x microcontroller "board" with USB and JTAG functionality.
  61. * Luminary Micro development board evb_lm3s811 JTAG interface.
  62. * ASIX PRESTO: http://www.asix-tools.com/prg_presto.htm
  63. The ASIX PRESTO is a USB JTAG programmer for a wide range of components, e.g.
  64. microcontrollers, serial EEPROM and Flash memory chips, CPLDs and others.
  65. * usbprog: http://www.embedded-projects.net/index.php?page_id=165
  66. The usbprog is a freely programmable USB adapter, which can (among other
  67. things) use a firmware which turns it into a JTAG programmer/debugger.
  68. All FT2232 based devices may be accessed using either FTDI's proprietary FTD2XX
  69. library (www.ftdichip.com) or using an open-source replacement from
  70. http://www.intra2net.com/de/produkte/opensource/ftdi/index.php, also included
  71. with many Linux distributions.
  72. 2. Supported cores
  73. This version of openocd supports the following ARM7/9 cores:
  74. - ARM7TDMI(-s)
  75. - ARM9TDMI
  76. - ARM920t
  77. - ARM922t
  78. - ARM926ej-s
  79. - ARM966e
  80. - Cortex-M3
  81. Support for Intel XScale CPUs is also included:
  82. - PXA25x
  83. - PXA27x
  84. - IXP42x
  85. 3. Host platforms
  86. OpenOCD was originally developed on x86-Linux, but has since then been ported
  87. to run on Windows/Cygwin, native Windows with MinGW, FreeBSD, IA64-Linux,
  88. AMD64-Linux, Alpha-Linux, ARM-Linux, and PowerPC OS-X.
  89. 4. Documentation
  90. Documentation for the OpenOCD is hosted in the Berlios OpenFacts Wiki at
  91. http://openfacts.berlios.de/index-en.phtml?title=Open_On-Chip_Debugger.
  92. 5. Licensing
  93. OpenOCD is licensed under the terms of the GNU General Public License, see the
  94. file COPYING for details.