How to set up Linux for USB JTAG adapters

I have a USB JTAG adapter that I want to use on Linux.  How do I do this?

Regular users generally do not by default have USB access permission on Linux. Depending on which Linux distribution you use, there are a number of different ways of granting regular users USB access permission.

On Ubuntu 12.04 and above, Linux Mint 14, openSUSE 12.2 and Fedora 17

You need to create a file in /etc/udev/rules.d (e.g. 60-crossconnect.rules) with the following contents:

SUBSYSTEMS=="usb", ATTRS{idVendor}=="131b", ATTRS{idProduct}=="0003", MODE="0666"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="131b", ATTRS{idProduct}=="0004", MODE="0666"

On Ubuntu 8.10 to 10.04, openSUSE 10.3 and Fedora 8

You need to create a file in /etc/udev/rules.d (e.g. 60-crossconnect.rules) with the following contents:

SUBSYSTEM=="usb", ACTION=="add", ENV{DEVTYPE}=="usb_device", \
SYSFS{idVendor}=="131b", SYSFS{idProduct}=="0003", MODE="0666"
SUBSYSTEM=="usb", ACTION=="add", ENV{DEVTYPE}=="usb_device", \
SYSFS{idVendor}=="131b", SYSFS{idProduct}=="0004", MODE="0666"

On Ubuntu 6.06 and Ubuntu 7.10

You need to create a file in /etc/udev/rules.d (e.g. 60-crossconnect.rules) with the following contents:

SUBSYSTEM=="usb_device", SYSFS{idVendor}=="131b", SYSFS{idProduct}=="0003", \
ACTION=="add" MODE="0666"
SUBSYSTEM=="usb_device", SYSFS{idVendor}=="131b", SYSFS{idProduct}=="0004", \
ACTION=="add" MODE="0666"

On RedHat 9.0

You need to add the following lines to the /etc/hotplug/usb.usermap file:

crossconnect 0x0003 0x131B 0x0003 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0
crossconnect 0x0003 0x131B 0x0004 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 

And create the script file /etc/hotplug/usb/crossconnect which contains:

#!/bin/bash
if [ "${ACTION}" = "add" ] && [ -f "${DEVICE}" ]; then
  chmod a+rw "${DEVICE}"
fi

Consult the USB documentation for your specific Linux distribution for more information.

Other Devices

Please note that the examples above are intended for ARM CrossConnects, which have a USB vendor ID of 0x131B and a USB product ID of 0x0003 and 0x0004. If you are using a different device you will need to modify the files so they contain the correct USB vendor and product IDs for your device. The following table describes the vendor and product IDs for other common USB ARM target interface devices:

Device	Vendor ID	Product ID
Amontec JTAGkey	0x0403	0xCFF8
Luminary USB Debug	0x0403	0xBCD9
Olimex ARM-USB-OCD	0x15BA	0x0003
Olimex ARM-USB-OCD-H	0x15BA	0x002B
Olimex ARM-USB-TINY	0x15BA	0x0004
Olimex ARM-USB-TINY-H	0x15BA	0x002A
Xverve Signalyzer H	0x0403	0xBCA2

For devices not on this list, you can determine the USB vendor and product IDs by connecting the device and running the following from the Linux command line:

lsusb -v