From: michael <michael>
Date: Tue, 1 May 2007 12:03:15 +0000 (+0000)
Subject: add documentation for FTDI2232 based devices
X-Git-Url: https://git.zerfleddert.de/cgi-bin/gitweb.cgi/usb-driver/commitdiff_plain/7606d470883f796049a23df206b18f0477622790
add documentation for FTDI2232 based devices
---
diff --git a/README b/README
index 768c724..d0eeb65 100644
--- a/README
+++ b/README
@@ -20,6 +20,10 @@ the following software:
* EDK 8.2.02i
* EDK 8.1.02i
+In addition to the XILINX USB and parallel cables, devices based on the FTDI
+2232 serial converter chip are also experimentally supported. This includes
+devices like the Amontec JTAGkey(-Tiny).
+
Build the library by calling `make'.
To use this library you have to preload the library before starting impact:
@@ -93,6 +97,32 @@ HIGHZ instead of BYPASS" enabled in Edit -> Preferences -> iMPACT Configuration
Preferences.
If you are using batch mode, add the following line to your cmd file:
setPreference -pref UseHighz:TRUE
-(This problem also occurs on windows and when using the real windrvr in linux and
-is solved with the same workaround. Impact 8.2 is working fine with the same
+(This problem also occurs on windows and when using the real windrvr in linux
+and is solved with the same workaround. Impact 8.2 is working fine with the same
boards and designs)
+
+
+Notes for FTDI 2232 based cables
+================================
+
+To build the driver with FTDI 2232 support, you need to have libftdi and
+the libftdi development package installed. On debian, you can install both
+by installing 'libftdi-dev'.
+
+To set-up the device:
+1. Find out the vendor and product id of your cable using lsusb:
+ Bus 003 Device 005: ID 0403:cff8 Future Technology Devices ...
+ ~~~~~~~~~
+
+2. Copy the sample libusb-driverrc to ~/.libusb-driverrc, edit it and replace
+ the vendor and product-id in the example file with the values from provided
+ in the lsusb-output. You can also change the 'parallel port' which is mapped
+ to this cable. Impact sees the device at that port as a Parallel Cable III.
+
+3. To use the device as an ordinary user, put the following line in a new file
+ in /etc/udev/rules.d/ and restart udev:
+ ACTION=="add", BUS=="usb", SYSFS{idVendor}=="0403", SYSFS{idProduct}=="cff8", MODE="666"
+ (replace the vendor and product id with your values)
+
+The support for FTDI 2232 based devices is currently experimental and they are
+currently significantly slowen than the other supported cables.
diff --git a/index.html b/index.html
index c7261c9..0d82a81 100644
--- a/index.html
+++ b/index.html
@@ -23,6 +23,10 @@
The USB cable is supported at full speed.
</P>
<P>
+ Experimental support for FTDI 2232 based devices has been added. They are seen by Impact as a Parallel
+ Cable III. These devices are currently significantly slower than every other supported cable.
+ </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>
@@ -36,12 +40,14 @@
<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&Nav2=Cables&Cat=Cable">Digilent JTAG3</a> Parallel Cable III clone</li>
+ <li><a href="http://www.amontec.com/">Amontec JTAGkey-Tiny</a> (experimental)</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>
+ <li>other FTDI2232 based devices which use the chips standard JTAG pinout (experimental)</li>
</ul>
<H2>Supported Software</H2>
The following software is reported to work with this driver:
@@ -74,6 +80,6 @@
<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.12 2007-04-22 11:41:58 michael Exp $</I></FONT>
+ <FONT SIZE="-1"><I><A HREF="mailto:cabledriver@zerfleddert.de">Michael Gernoth</A>, $Id: index.html,v 1.13 2007-05-01 12:03:15 michael Exp $</I></FONT>
</BODY>
</HTML>