Next: About JIM-Tcl, Previous: Developers, Up: Top

## 2 Debug Adapter Hardware

Defined: dongle: A small device that plugins into a computer and serves as an adapter .... [snip]

In the OpenOCD case, this generally refers to a small adapter that attaches to your computer via USB or the Parallel Printer Port. One exception is the Zylin ZY1000, packaged as a small box you attach via an ethernet cable. The Zylin ZY1000 has the advantage that it does not require any drivers to be installed on the developer PC. It also has a built in web interface. It supports RTCK/RCLK or adaptive clocking and has a built in relay to power cycle targets remotely.

### 2.1 Choosing a Dongle

There are several things you should keep in mind when choosing a dongle.

1. Transport Does it support the kind of communication that you need? OpenOCD focusses mostly on JTAG. Your version may also support other ways to communicate with target devices.
2. Voltage What voltage is your target - 1.8, 2.8, 3.3, or 5V? Does your dongle support it? You might need a level converter.
3. Pinout What pinout does your target board use? Does your dongle support it? You may be able to use jumper wires, or an "octopus" connector, to convert pinouts.
4. Connection Does your computer have the USB, printer, or Ethernet port needed?
5. RTCK Do you expect to use it with ARM chips and boards with RTCK support? Also known as “adaptive clocking”

### 2.2 Stand alone Systems

ZY1000 See: http://www.zylin.com/zy1000.html Technically, not a dongle, but a standalone box. The ZY1000 has the advantage that it does not require any drivers installed on the developer PC. It also has a built in web interface. It supports RTCK/RCLK or adaptive clocking and has a built in relay to power cycle targets remotely.

### 2.3 USB FT2232 Based

There are many USB JTAG dongles on the market, many of them are based on a chip from “Future Technology Devices International” (FTDI) known as the FTDI FT2232; this is a USB full speed (12 Mbps) chip. See: http://www.ftdichip.com for more information. In summer 2009, USB high speed (480 Mbps) versions of these FTDI chips are starting to become available in JTAG adapters. (Adapters using those high speed FT2232H chips may support adaptive clocking.)

The FT2232 chips are flexible enough to support some other transport options, such as SWD or the SPI variants used to program some chips. They have two communications channels, and one can be used for a UART adapter at the same time the other one is used to provide a debug adapter.

Also, some development boards integrate an FT2232 chip to serve as a built-in low cost debug adapter and usb-to-serial solution.

- usbjtag
  Link http://www.hs-augsburg.de/~hhoegl/proj/usbjtag/usbjtag.html
- jtagkey
  See: http://www.amontec.com/jtagkey.shtml
- jtagkey2
  See: http://www.amontec.com/jtagkey2.shtml
- oocdlink
  See: http://www.oocdlink.com By Joern Kaipf
- signalyzer
  See: http://www.signalyzer.com
- Stellaris Eval Boards
  See: http://www.luminarymicro.com - The Stellaris eval boards bundle FT2232-based JTAG and SWD support, which can be used to debug the Stellaris chips. Using separate JTAG adapters is optional. These boards can also be used in a "pass through" mode as JTAG adapters to other target boards, disabling the Stellaris chip.
- Luminary ICDI
  See: http://www.luminarymicro.com - Luminary In-Circuit Debug Interface (ICDI) Boards are included in Stellaris LM3S9B9x Evaluation Kits. Like the non-detachable FT2232 support on the other Stellaris eval boards, they can be used to debug other target boards.
- olimex-jtag
  See: http://www.olimex.com
- flyswatter
  See: http://www.tincantools.com
- turtelizer2
  See: Turtelizer 2, or http://www.ethernut.de
- comstick
  Link: http://www.hitex.com/index.php?id=383
- stm32stick
  Link http://www.hitex.com/stm32-stick
- axm0432_jtag
  Axiom AXM-0432 Link http://www.axman.com
- cortino
  Link http://www.hitex.com/index.php?id=cortino

### 2.4 USB-JTAG / Altera USB-Blaster compatibles

These devices also show up as FTDI devices, but are not protocol-compatible with the FT2232 devices. They are, however, protocol-compatible among themselves. USB-JTAG devices typically consist of a FT245 followed by a CPLD that understands a particular protocol, or emulate this protocol using some other hardware.

They may appear under different USB VID/PID depending on the particular product. The driver can be configured to search for any VID/PID pair (see the section on driver commands).

- USB-JTAG Kolja Waschk's USB Blaster-compatible adapter
  Link: http://www.ixo.de/info/usb_jtag/
- Altera USB-Blaster
  Link: http://www.altera.com/literature/ug/ug_usb_blstr.pdf

### 2.5 USB JLINK based

There are several OEM versions of the Segger JLINK adapter. It is an example of a micro controller based JTAG adapter, it uses an AT91SAM764 internally.

- ATMEL SAMICE Only works with ATMEL chips!
  Link: http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3892
- SEGGER JLINK
  Link: http://www.segger.com/jlink.html
- IAR J-Link
  Link: http://www.iar.com/website1/1.0.1.0/369/1/index.php

### 2.6 USB RLINK based

Raisonance has an adapter called RLink. It exists in a stripped-down form on the STM32 Primer, permanently attached to the JTAG lines. It also exists on the STM32 Primer2, but that is wired for SWD and not JTAG, thus not supported.

- Raisonance RLink
  Link: http://www.raisonance.com/products/RLink.php
- STM32 Primer
  Link: http://www.stm32circle.com/resources/stm32primer.php
- STM32 Primer2
  Link: http://www.stm32circle.com/resources/stm32primer2.php

### 2.7 USB Other

- USBprog
  Link: http://www.embedded-projects.net/usbprog - which uses an Atmel MEGA32 and a UBN9604
- USB - Presto
  Link: http://tools.asix.net/prg_presto.htm
- Versaloon-Link
  Link: http://www.simonqian.com/en/Versaloon
- ARM-JTAG-EW
  Link: http://www.olimex.com/dev/arm-jtag-ew.html
- Buspirate
  Link: http://dangerousprototypes.com/bus-pirate-manual/

### 2.8 IBM PC Parallel Printer Port Based

The two well known “JTAG Parallel Ports” cables are the Xilnx DLC5 and the MacGraigor Wiggler. There are many clones and variations of these on the market.

Note that parallel ports are becoming much less common, so if you have the choice you should probably avoid these adapters in favor of USB-based ones.

- Wiggler - There are many clones of this.
  Link: http://www.macraigor.com/wiggler.htm
- DLC5 - From XILINX - There are many clones of this
  Link: Search the web for: “XILINX DLC5” - it is no longer produced, PDF schematics are easily found and it is easy to make.
- Amontec - JTAG Accelerator
  Link: http://www.amontec.com/jtag_accelerator.shtml
- GW16402
  Link: http://www.gateworks.com/products/avila_accessories/gw16042.php
- Wiggler2
  Improved parallel-port wiggler-style JTAG adapter
- Wiggler_ntrst_inverted
  Yet another variation - See the source code, src/jtag/parport.c
- old_amt_wiggler
  Unknown - probably not on the market today
- arm-jtag
  Link: Most likely http://www.olimex.com/dev/arm-jtag.html [another wiggler clone]
- chameleon
  Link: http://www.amontec.com/chameleon.shtml
- Triton
  Unknown.
- Lattice
  ispDownload from Lattice Semiconductor http://www.latticesemi.com/lit/docs/devtools/dlcable.pdf
- flashlink
  From ST Microsystems; FlashLINK JTAG programing cable for PSD and uPSD

### 2.9 Other...

- ep93xx
  An EP93xx based Linux machine using the GPIO pins directly.
- at91rm9200
  Like the EP93xx - but an ATMEL AT91RM9200 based solution using the GPIO pins on the chip.