[usb-driver] / index.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML>
	<HEAD>
		<TITLE>XILINX USB/Parallel JTAG cables on Linux without windrvr</TITLE>
	</HEAD>
	<BODY BGCOLOR="#FFFFFF" TEXT="#000000">
		<H1>XILINX JTAG tools on Linux without proprietary kernel modules</H1>
		<H2>About</H2>
		<P>
		When using <a href="http://www.xilinx.com">XILINX</a> JTAG software like Impact, Chipscope and XMD
		on Linux, the proprietary kernel module <i>windrvr</i> from <a href="http://www.jungo.com">Jungo</a>
		is needed to access the parallel- or usb-cable.
		As this module does not work with current linux kernel versions (&gt; 2.6.18) a library was developed,
		which emulates the module in userspace and allows the tools to access the JTAG cable without the need
		for a proprietary kernel module.
		</P>
		<P>
		The library uses <a href="http://libusb.sourceforge.net/">libusb</a> to access USB devices and the
		<a href="http://people.redhat.com/twaugh/parport/html/x623.html">ppdev</a> interface to communicate
		with parallel cables. The parallel part currently only supports Parallel Cable III mode (and PCIV in
		PCIII compatibility mode) as the faster PCIV modes use another kernel module which is not emulated by
		this library. So you are limited to a 200kHz JTAG clock when using Parallel Cable IV with this software.
		The USB cable is supported at full speed.
		</P>
		<P>
		The library is called <i>libusb-driver</i> as it was developed to support the USB cable, but later
		extended to also support parallel cables.
		</P>
		<H2>Supported Cables</H2>
		The following cables are reported to work with this driver:
		<ul>
			<li><a href="http://direct.xilinx.com/bvdocs/publications/ds300.pdf">XILINX Platform Cable USB DLC9LP</a></li>
			<li><a href="http://www.xilinx.com/s3estarter">Integrated Platform Cable USB on Spartan 3E starter kit</a></li>
			<li><a href="http://direct.xilinx.com/bvdocs/publications/ds097.pdf">XILINX Parallel Cable IV</a> (in Parallel Cable III compatibility mode)</li>
			<li><a href="http://www.enterpoint.co.uk/">Enterpoint Prog2</a> Parallel Cable III clone</li>
			<li><a href="http://www.trenz-electronic.de/">Trenz TE0149-01</a> Parallel Cable III clone</li>
			<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>
		</ul>
		These cables should work but have not yet been tested:
		<ul>
			<li>XILINX Platform Cable USB DLC9 and DLC9G</li>
			<li>Integrated Platform Cable USB on other development boards</li>
			<li>other Parallel Cable III clones</li>
		</ul>
		<H2>Supported Software</H2>
		The following software is reported to work with this driver:
		<ul>
			<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.1SP3</a></li>
			<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.1SP2</a></li>
			<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.1SP1</a></li>
			<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 8.2SP3</a></li>
			<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 8.1SP3</a></li>
			<li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 9.1.03i</a></li>
			<li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 9.1.02i</a></li>
			<li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 8.2.04i</a></li>
			<li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 8.2.02i</a></li>
			<li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 8.1.02i</a></li>
		</ul>
		<H2>Download</H2>
		<ul>
			<li>Download <a href="http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/usb-driver.tar.gz">usb-driver.tar.gz</a> (to build it, you need to have the libusb development package installed. It is called libusb-dev on Debian.)</li>
			<li>Read the <a href="http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/*checkout*/usb-driver/README">README</a></li>
			<li>Browse the <a href="http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/usb-driver/">CVS repository</a></li>
			<li>Precompiled <a href="libusb-driver.so">libusb-driver.so</a> for Debian Etch, but better build your own</li>
		</ul>
		<H2>Links</H2>
		<ul>
			<li><a href="http://groups.google.com/group/comp.arch.fpga/msg/2dfa36541174a4f2">Ubuntu installation instructions by Luzerne</a></li>
			<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>
			<li><a href="http://groups.google.com/group/comp.arch.fpga/browse_frm/thread/f149e5b6028e2c70">Initial announcement on comp.arch.fpga</a></li>
			<li><a href="http://inisyn.org/src/xup/">XUP</a> by inisyn research, opensource JTAG programming for Spartan 3E starter kit USB cable</li>
			<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>
			<li><a href="http://www.rogerstech.co.uk/xc3sprog/">Spartan3 JTAG download tools for GNU/Linux (xc3sprog)</a></li>
		</ul>
		<HR>
		<FONT SIZE="-1"><I><A HREF="mailto:cabledriver@zerfleddert.de">Michael Gernoth</A>, $Id: index.html,v 1.10 2007-04-15 16:16:13 michael Exp $</I></FONT>
	</BODY>
</HTML>
Commit	Line	Data
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>
	8	<H2>About</H2>
	9	<P>
	10	When using <a href="http://www.xilinx.com">XILINX</a> JTAG software like Impact, Chipscope and XMD
2b78cb99	11	on Linux, the proprietary kernel module <i>windrvr</i> from <a href="http://www.jungo.com">Jungo</a>
026cbe49	12	is needed to access the parallel- or usb-cable.
	13	As this module does not work with current linux kernel versions (> 2.6.18) a library was developed,
	14	which emulates the module in userspace and allows the tools to access the JTAG cable without the need
	15	for a proprietary kernel module.
	16	</P>
	17	<P>
	18	The library uses <a href="http://libusb.sourceforge.net/">libusb</a> to access USB devices and the
4d2daea0	19	<a href="http://people.redhat.com/twaugh/parport/html/x623.html">ppdev</a> interface to communicate
026cbe49	20	with parallel cables. The parallel part currently only supports Parallel Cable III mode (and PCIV in
	21	PCIII compatibility mode) as the faster PCIV modes use another kernel module which is not emulated by
	22	this library. So you are limited to a 200kHz JTAG clock when using Parallel Cable IV with this software.
	23	The USB cable is supported at full speed.
	24	</P>
	25	<P>
	26	The library is called <i>libusb-driver</i> as it was developed to support the USB cable, but later
	27	extended to also support parallel cables.
	28	</P>
	29	<H2>Supported Cables</H2>
	30	The following cables are reported to work with this driver:
	31	<ul>
	32	<li><a href="http://direct.xilinx.com/bvdocs/publications/ds300.pdf">XILINX Platform Cable USB DLC9LP</a></li>
	33	<li><a href="http://www.xilinx.com/s3estarter">Integrated Platform Cable USB on Spartan 3E starter kit</a></li>
21a5b635	34	<li><a href="http://direct.xilinx.com/bvdocs/publications/ds097.pdf">XILINX Parallel Cable IV</a> (in Parallel Cable III compatibility mode)</li>
026cbe49	35	<li><a href="http://www.enterpoint.co.uk/">Enterpoint Prog2</a> Parallel Cable III clone</li>
026cbe49	36	<li><a href="http://www.trenz-electronic.de/">Trenz TE0149-01</a> Parallel Cable III clone</li>
9ec5ba04	37	<li><a href="http://www.digilentinc.com/Products/Catalog.cfm?Nav1=Products&Nav2=Cables&Cat=Cable">Digilent JTAG3</a> Parallel Cable III clone</li>
026cbe49	38	</ul>
78d5d21d	39	These cables should work but have not yet been tested:
	40	<ul>
	41	<li>XILINX Platform Cable USB DLC9 and DLC9G</li>
	42	<li>Integrated Platform Cable USB on other development boards</li>
	43	<li>other Parallel Cable III clones</li>
	44	</ul>
026cbe49	45	<H2>Supported Software</H2>
	46	The following software is reported to work with this driver:
	47	<ul>
	48	<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.1SP3</a></li>
	49	<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.1SP2</a></li>
	50	<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 9.1SP1</a></li>
	51	<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 8.2SP3</a></li>
	52	<li><a href="http://www.xilinx.com/ise/logic_design_prod/webpack.htm">ISE Webpack 8.1SP3</a></li>
	53	<li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 9.1.03i</a></li>
	54	<li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 9.1.02i</a></li>
	55	<li><a href="http://www.xilinx.com/ise/optional_prod/cspro.htm">ChipScope Pro 8.2.04i</a></li>
	56	<li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 8.2.02i</a></li>
2271fdf2	57	<li><a href="http://www.xilinx.com/ise/embedded_design_prod/platform_studio.htm">EDK 8.1.02i</a></li>
026cbe49	58	</ul>
	59	<H2>Download</H2>
	60	<ul>
41d0a9f7	61	<li>Download <a href="http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/usb-driver.tar.gz">usb-driver.tar.gz</a> (to build it, you need to have the libusb development package installed. It is called libusb-dev on Debian.)</li>
026cbe49	62	<li>Read the <a href="http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/checkout/usb-driver/README">README</a></li>
026cbe49	63	<li>Browse the <a href="http://cvs.zerfleddert.de/cgi-bin/viewcvs.cgi/usb-driver/">CVS repository</a></li>
9ec5ba04	64	<li>Precompiled <a href="libusb-driver.so">libusb-driver.so</a> for Debian Etch, but better build your own</li>
41d0a9f7	65	</ul>
	66	<H2>Links</H2>
	67	<ul>
9ec5ba04	68	<li><a href="http://groups.google.com/group/comp.arch.fpga/msg/2dfa36541174a4f2">Ubuntu installation instructions by Luzerne</a></li>
41d0a9f7	69	<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	70	<li><a href="http://groups.google.com/group/comp.arch.fpga/browse_frm/thread/f149e5b6028e2c70">Initial announcement on comp.arch.fpga</a></li>
57d4107e	71	<li><a href="http://inisyn.org/src/xup/">XUP</a> by inisyn research, opensource JTAG programming for Spartan 3E starter kit USB cable</li>
57d4107e	72	<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	73	<li><a href="http://www.rogerstech.co.uk/xc3sprog/">Spartan3 JTAG download tools for GNU/Linux (xc3sprog)</a></li>
026cbe49	74	</ul>
026cbe49	75	<HR>
2271fdf2	76	<FONT SIZE="-1"><I><A HREF="mailto:cabledriver@zerfleddert.de">Michael Gernoth</A>, $Id: index.html,v 1.10 2007-04-15 16:16:13 michael Exp $</I></FONT>
026cbe49	77	</BODY>
026cbe49	78	</HTML>