add location of official libusb-based driver
[usb-driver] / index.html
CommitLineData
026cbe49 1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3 <HEAD>
4 <TITLE>XILINX USB/Parallel JTAG cables on Linux without windrvr</TITLE>
5 </HEAD>
6 <BODY BGCOLOR="#FFFFFF" TEXT="#000000">
7 <H1>XILINX JTAG tools on Linux without proprietary kernel modules</H1>
2ede2e55
MG
8 <P><B>News</B> (<I>2008-03-26</I>): Xilinx is about to release their own drivers based on libusb.
9 They will be located at:
10 <A HREF="http://www.xilinx.com/support/answers/25249.htm">http://www.xilinx.com/support/answers/25249.htm</A>
11 </P>
026cbe49 12 <H2>About</H2>
13 <P>
14 When using <a href="http://www.xilinx.com">XILINX</a> JTAG software like Impact, Chipscope and XMD
2b78cb99 15 on Linux, the proprietary kernel module <i>windrvr</i> from <a href="http://www.jungo.com">Jungo</a>
026cbe49 16 is needed to access the parallel- or usb-cable.
17 As this module does not work with current linux kernel versions (&gt; 2.6.18) a library was developed,
18 which emulates the module in userspace and allows the tools to access the JTAG cable without the need
19 for a proprietary kernel module.
20 </P>
21 <P>
22 The library uses <a href="http://libusb.sourceforge.net/">libusb</a> to access USB devices and the
4d2daea0 23 <a href="http://people.redhat.com/twaugh/parport/html/x623.html">ppdev</a> interface to communicate
026cbe49 24 with parallel cables. The parallel part currently only supports Parallel Cable III mode (and PCIV in
25 PCIII compatibility mode) as the faster PCIV modes use another kernel module which is not emulated by
26 this library. So you are limited to a 200kHz JTAG clock when using Parallel Cable IV with this software.
27 The USB cable is supported at full speed.
28 </P>
29 <P>
7606d470 30 Experimental support for FTDI 2232 based devices has been added. They are seen by Impact as a Parallel
31 Cable III. These devices are currently significantly slower than every other supported cable.
32 </P>
33 <P>
026cbe49 34 The library is called <i>libusb-driver</i> as it was developed to support the USB cable, but later
35 extended to also support parallel cables.
36 </P>
37 <H2>Supported Cables</H2>
38 The following cables are reported to work with this driver:
39 <ul>
e9a331c7 40 <li><a href="http://direct.xilinx.com/bvdocs/publications/ds300.pdf">XILINX Platform Cable USB DLC9, DLC9LP and DLC9G</a></li>
026cbe49 41 <li><a href="http://www.xilinx.com/s3estarter">Integrated Platform Cable USB on Spartan 3E starter kit</a></li>
de6f38de 42 <li><a href="http://www.xilinx.com/s3astarter">Integrated Platform Cable USB on Spartan 3A starter kit</a></li>
20ce0945 43 <li><a href="http://www.digilentinc.com/Products/Detail.cfm?Nav1=Products&Nav2=Programmable&Prod=XUPV2P">Integrated Platform Cable USB on XUP-V2Pro</a></li>
21a5b635 44 <li><a href="http://direct.xilinx.com/bvdocs/publications/ds097.pdf">XILINX Parallel Cable IV</a> (in Parallel Cable III compatibility mode)</li>
026cbe49 45 <li><a href="http://www.enterpoint.co.uk/">Enterpoint Prog2</a> Parallel Cable III clone</li>
46 <li><a href="http://www.trenz-electronic.de/">Trenz TE0149-01</a> Parallel Cable III clone</li>
9ec5ba04 47 <li><a href="http://www.digilentinc.com/Products/Catalog.cfm?Nav1=Products&amp;Nav2=Cables&amp;Cat=Cable">Digilent JTAG3</a> Parallel Cable III clone</li>
7606d470 48 <li><a href="http://www.amontec.com/">Amontec JTAGkey-Tiny</a> (experimental)</li>
026cbe49 49 </ul>
78d5d21d 50 These cables should work but have not yet been tested:
51 <ul>
78d5d21d 52 <li>Integrated Platform Cable USB on other development boards</li>
53 <li>other Parallel Cable III clones</li>
7606d470 54 <li>other FTDI2232 based devices which use the chips standard JTAG pinout (experimental)</li>
78d5d21d 55 </ul>
026cbe49 56 <H2>Supported Software</H2>
57 The following software is reported to work with this driver:
58 <ul>
04d489ad 59 <li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.2 SP1, SP2, SP3 and SP4</a></li>
59fab31f
MG
60 <li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.1 SP1, SP2 and SP3</a></li>
61 <li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 8.2 SP3</a></li>
62 <li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 8.1 SP3</a></li>
04d489ad 63 <li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 9.2.01i, 9.2.02i, 9.2.03i and 9.2.04i</a></li>
59fab31f 64 <li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 9.1.02i and 9.1.03i</a></li>
026cbe49 65 <li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 8.2.04i</a></li>
b9423a53 66 <li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 9.2.01i and 9.2.02i</a></li>
59fab31f 67 <li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 9.1.01i and 9.1.02i</a></li>
026cbe49 68 <li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 8.2.02i</a></li>
2271fdf2 69 <li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 8.1.02i</a></li>
337944d1 70 <li><a href="http://www.synplicity.com/products/identify/index.html">Synplicity Identify Debugger</a></li>
026cbe49 71 </ul>
72 <H2>Download</H2>
73 <ul>
8d29f0a4 74 <li>Download <a href="http://git.zerfleddert.de/cgi-bin/gitweb.cgi/usb-driver?a=snapshot;h=HEAD;sf=tgz">usb-driver-HEAD.tar.gz</a> (to build it, you need to have the libusb development package installed. It is called libusb-dev on Debian.)</li>
badd6a82 75 <li>Read the <a href="http://git.zerfleddert.de/cgi-bin/gitweb.cgi/usb-driver?a=blob_plain;f=README;hb=HEAD">README</a></li>
e9b47752 76 <li>Browse the <a href="http://git.zerfleddert.de/cgi-bin/gitweb.cgi/usb-driver?a=tree">Git repository</a> (<a href="http://git.zerfleddert.de/cgi-bin/gitweb.cgi/usb-driver">Summary</a>)</li>
9ec5ba04 77 <li>Precompiled <a href="libusb-driver.so">libusb-driver.so</a> for Debian Etch, but better build your own</li>
b22eea29 78 <li>Clone the <a href="http://git.or.cz/">Git</a> repository with: <kbd>git clone git://git.zerfleddert.de/usb-driver</kbd></li>
41d0a9f7 79 </ul>
80 <H2>Links</H2>
81 <ul>
5029ac18
MG
82 <li><a href="http://groups.google.com/group/comp.arch.fpga/msg/94d8bb1f52e06b44">XILINX listened</a></li>
83 <li><a href="http://svenand.blogdrive.com/archive/55.html">Installation instructions using a MacBook running Ubuntu in VMware by Sven Andersson</a></li>
b3158171 84 <li><a href="http://groups.google.com/group/comp.arch.fpga/browse_thread/thread/954a145428ec2c54/555f6bfb766a3a93#555f6bfb766a3a93">Using the libusb-driver on a 64bit system with a 32bit ISE by Ken Ryan</a></li>
9ec5ba04 85 <li><a href="http://groups.google.com/group/comp.arch.fpga/msg/2dfa36541174a4f2">Ubuntu installation instructions by Luzerne</a></li>
41d0a9f7 86 <li><a href="http://www.itee.uq.edu.au/~listarch/microblaze-uclinux/archive/2007/03/msg00101.html">Ubuntu installation instructions by Paul-Armand Verhaegen</a></li>
9ec5ba04 87 <li><a href="http://groups.google.com/group/comp.arch.fpga/browse_frm/thread/f149e5b6028e2c70">Initial announcement on comp.arch.fpga</a></li>
57d4107e 88 <li><a href="http://inisyn.org/src/xup/">XUP</a> by inisyn research, opensource JTAG programming for Spartan 3E starter kit USB cable</li>
89 <li><a href="http://www.ixo.de/info/usb_jtag/">USB JTAG adapter</a> by Kolja Waschk, opensource integration of the XILINX platform cable USB into OpenOCD and openwince JTAG Tools</li>
295cadbc 90 <li><a href="http://www.rogerstech.co.uk/xc3sprog/">Spartan3 JTAG download tools for GNU/Linux (xc3sprog)</a></li>
026cbe49 91 </ul>
92 <HR>
f19a030c 93 <FONT SIZE="-1"><I><A HREF="mailto:cabledriver@zerfleddert.de">Michael Gernoth</A></I></FONT>
026cbe49 94 </BODY>
95</HTML>
Impressum, Datenschutz