{{Note|The installation is last known to work with Linux kernel 3.1.4 and Xilinx ISE 13.3.}}

−

http://gentoo-wiki.com/HOWTO_Xilinx

+

The ISE WebPACK Linux version can be downloaded from [http://www.xilinx.com/support/download/index.htm the official download page]. It requires registration and licensing agreement, but there is no charge, i.e. it's free as in "free beer", but not free as in "free speech".

−

and this is a Xilinx tip for usb install on Linux:

+

Once the tarball is downloaded, unpack it and run the installer:

+

$ tar xf Xilinx_ISE_DS_Lin_13.3_O.76xd.1.0.tar

+

$ cd Xilinx_ISE_DS_Lin_13.3_O.76xd.1.0

+

$ ./xsetup

−

http://www.xilinx.com/support/answers/22648.htm

+

Then, follow the instructions to install the ISE. By default, the whole application is installed to {{ic|/opt/Xilinx/}}, so make sure the user running the installer has permissions to write to this directory.

−

Once ready to download I used, and recommend, the "Download Files Individually" option, once you reach the download page. This downloads the entire installer and installation is performed afterward via:

+

After installation, the ISE can be launched from {{ic|/opt/Xilinx/13.3/ISE_DS/ISE/bin/lin/ise}}. Design capture, synthesis and simulation features should work out-of-box.

−

tar xf webpack_SFD.tar

+

== Troubleshooting ==

−

cd webpack

+

However once I reached the point of trying to download a design to a target device I ran into some trouble. Installing the cable drivers for talking to the target interface cable yielded errors.

−

./setup

−

Xilinx only provides official support for redhat and suse distributions, but I found the initial install of ISE to go smoothly on archlinux with kernel-headers 2.6.24.3-1.

I first installed ISE WebPACK for Linux version 9.2i, but 10.1 was released shortly thereafter. I was pleased to see this updated version was available for linux at the same time as 10.1 for windoze.

−

−

After installation, ISE worked fine for design capture, synthesis and simulation. However once I reached the point of trying to download a design to a target device I ran into some trouble. Installing the cable drivers for talking to the target interface cable yielded errors.

−

−

I downloaded the standalone driver installation utility from:

−

−

ftp://ftp.xilinx.com/pub/utilities/fpga/install_drivers.tar.gz

This download yields a file named install_drivers.tar.gz

This download yields a file named install_drivers.tar.gz

−

tar xzf install_drivers.tar.gz

+

$ tar xzf install_drivers.tar.gz

−

+

yields a directory named install_drivers/. When I attempted to build the drivers from this file I encountered the following errors:

−

yields a directory named install_drivers/ When I attempted to build the drivers from this file I encountered the following errors:

+

'''linux_wrappers.c:48:31: error: linux/ioctl32.h: No such file or directory'''

−

−

'''linux_wrappers.c:48:31: error: linux/ioctl32.h: No such file or directory'''

−

and

and

+

'''linux_wrappers.c:1398: error: ‘struct scatterlist’ has no member named ‘page’'''

−

'''linux_wrappers.c:1398: error: ‘struct scatterlist’ has no member named ‘page’'''

+

Reading in the Gentoo HOWTO's listed above led me to download the latest Jungo source code, which is the core of the Xilinix linux USB support. I modified the link after reading that the latest Jungo driver was 9.20. I got WinDriver 9.20 from: http://www.jungo.com/st/download/WD920LN.tgz

−

−

Reading in the Gentoo HOWTO's listed above led me to download the latest Jungo source code, which is the core of the Xilinix linux USB support. I modified the link after reading that the latest Jungo driver was 9.20. I got WinDriver 9.20 from:

−

−

http://www.jungo.com/st/download/WD920LN.tgz

−

−

tar xzg WD920LN.tgz

+

$ tar xzf WD920LN.tgz

yields a directory named WinDriver/ Within this directory you'll find:

yields a directory named WinDriver/ Within this directory you'll find:

This update to the Jungo driver eliminated the error: linux/ioctl32.h: No such file or directory, but the error: ‘struct scatterlist’ has no member named ‘page’ was still persisting.

This update to the Jungo driver eliminated the error: linux/ioctl32.h: No such file or directory, but the error: ‘struct scatterlist’ has no member named ‘page’ was still persisting.

−

After research regarding changes to scatterlist.h lead to these discussions:

+

After research regarding changes to scatterlist.h lead to these discussions: http://kerneltrap.org/Linux/SG_Chaining_Merged

−

−

http://kerneltrap.org/Linux/SG_Chaining_Merged

Which describe changes in scatter/gather lists that were implemented in kernel 2.6.23 in Oct 2007.

Which describe changes in scatter/gather lists that were implemented in kernel 2.6.23 in Oct 2007.

I implemented the following:

I implemented the following:

−

+

$ cd install_drivers/linux_drivers/windriver32/windrvr/

−

cd install_drivers/linux_drivers/windriver32/windrvr/

and apply the patch indicated below to linux_wrappers.c:

and apply the patch indicated below to linux_wrappers.c:

Line 198:

Line 167:

This corrected all compilation errors, but the xpc4drvr.ko still yielded the following error in /var/log/everything.log whenever it was attempted to be loaded:

This corrected all compilation errors, but the xpc4drvr.ko still yielded the following error in /var/log/everything.log whenever it was attempted to be loaded:

−

xpc4drvr: Unknown symbol get_user_size

xpc4drvr: Unknown symbol get_user_size

However this did allow compilation of the entire driver tree and the install script was able to successfully install the drivers via:

However this did allow compilation of the entire driver tree and the install script was able to successfully install the drivers via:

−

cd install_drivers/

cd install_drivers/

./install_drivers

./install_drivers

Line 208:

Line 175:

There is also a udev rule entry that will make the driver accessible to all users after each reboot. (Which I haven't yet applied)

There is also a udev rule entry that will make the driver accessible to all users after each reboot. (Which I haven't yet applied)

−

So after this brief modification, I am able to successfully run ISE on ArchLinux-2.6.24 with full USB cable support.

+

So after this brief modification, I am able to successfully run ISE on Arch Linux (kernel26 2.6.24) with full USB cable support.

−

There is a GPL'd libusb based driver mentioned in the Gentoo HOWTO:

+

There is a GPL'd libusb based driver mentioned in the Gentoo HOWTO: http://www.rmdir.de/~michael/xilinx/ that I was particularly interested in using. However while the source built without error, I continued to receive runtime errors when attempting to run it in ISE.

−

−

http://www.rmdir.de/~michael/xilinx/

−

−

that I was particularly interested in using. However while the source built without error, I continued to receive runtime errors when attempting to run it in ISE.

I never attempted to use the Xup driver.

I never attempted to use the Xup driver.

There were quite a few pertinent facts along the way that I'm failing to capture here. Such as the fact that I discovered the same directory:

There were quite a few pertinent facts along the way that I'm failing to capture here. Such as the fact that I discovered the same directory:

−

install_drivers/

install_drivers/

in the base install of the entire ISE package under:

in the base install of the entire ISE package under:

−

/opt/Xilinx/10.1/common/bin/lin/install_script/install_drivers/

/opt/Xilinx/10.1/common/bin/lin/install_script/install_drivers/

Line 236:

Line 197:

Happy Hardware Hacking!!!

Happy Hardware Hacking!!!

−

'''android'''

+

== Update 2010-08-02 ==

+

+

Comments in the forum thread announcing this wiki entry make reference to the page:

+

+

http://rmdir.de/~michael/xilinx/

+

+

This is the upstream source for non-proprietary Xilinx USB drivers using libusb. This is now the Xilinx recommended linux usb interface and is shipped with new versions of Xilinx ISE WebPack.

+

+

Per a note on the rmdir.de website, newer versions of udev no longer support the older syntax of the /etc/udev/rules.d/xusbdfwu.rules file:

+

<pre>

+

* 2010-03-15: If you are using newer udev-versions (like the version included in Debian Squeeze and Ubuntu 9.10), then the file /etc/udev/rules.d/xusbdfwu.rules is incompatible with this udev version. The effect of this is that the cable-firmware gets never loaded and the cable led never lights up.

I didn't require a reboot for this patch to take affect while running:

+

<pre>

+

[root@vhost pcusb]# pacman -Q udev

+

udev 151-3

+

[root@vhost pcusb]# pacman -Q kernel26

+

kernel26 2.6.33.4-1

+

</pre>

+

In both the x86_64 host and the i686 chroot.

+

+

android

+

+

== Update 2012-04-26 ==

+

I had a problem with PlanAhead software wich is based on Java, there is non-rendered window. It appears that this problem is a re-manifestation of the Java bug, which was meant to have been fixed in an early version of Java 1.6. Using MToolkit makes the workaroud:

Contents

Installation

Note: The installation is last known to work with Linux kernel 3.1.4 and Xilinx ISE 13.3.

The ISE WebPACK Linux version can be downloaded from the official download page. It requires registration and licensing agreement, but there is no charge, i.e. it's free as in "free beer", but not free as in "free speech".

Then, follow the instructions to install the ISE. By default, the whole application is installed to /opt/Xilinx/, so make sure the user running the installer has permissions to write to this directory.

After installation, the ISE can be launched from /opt/Xilinx/13.3/ISE_DS/ISE/bin/lin/ise. Design capture, synthesis and simulation features should work out-of-box.

Troubleshooting

However once I reached the point of trying to download a design to a target device I ran into some trouble. Installing the cable drivers for talking to the target interface cable yielded errors.

yields a directory named install_drivers/. When I attempted to build the drivers from this file I encountered the following errors:

linux_wrappers.c:48:31: error: linux/ioctl32.h: No such file or directory

and

linux_wrappers.c:1398: error: ‘struct scatterlist’ has no member named ‘page’

Reading in the Gentoo HOWTO's listed above led me to download the latest Jungo source code, which is the core of the Xilinix linux USB support. I modified the link after reading that the latest Jungo driver was 9.20. I got WinDriver 9.20 from: http://www.jungo.com/st/download/WD920LN.tgz

$ tar xzf WD920LN.tgz

yields a directory named WinDriver/ Within this directory you'll find:

This corrected the compile errors in the Jungo USB driver and produced the windrvr6.ko kernel module. However there was still a nagging error in the compilation of install_drivers/linux_drivers/xpc4drvr2_6/xpc4drvr/

This corrected all compilation errors, but the xpc4drvr.ko still yielded the following error in /var/log/everything.log whenever it was attempted to be loaded:

xpc4drvr: Unknown symbol get_user_size

However this did allow compilation of the entire driver tree and the install script was able to successfully install the drivers via:

cd install_drivers/
./install_drivers

There is also a udev rule entry that will make the driver accessible to all users after each reboot. (Which I haven't yet applied)

So after this brief modification, I am able to successfully run ISE on Arch Linux (kernel26 2.6.24) with full USB cable support.

There is a GPL'd libusb based driver mentioned in the Gentoo HOWTO: http://www.rmdir.de/~michael/xilinx/ that I was particularly interested in using. However while the source built without error, I continued to receive runtime errors when attempting to run it in ISE.

I never attempted to use the Xup driver.

There were quite a few pertinent facts along the way that I'm failing to capture here. Such as the fact that I discovered the same directory:

install_drivers/

in the base install of the entire ISE package under:

/opt/Xilinx/10.1/common/bin/lin/install_script/install_drivers/

I would expect that this procedure could be applied directly to that without the additional step of downloading the install_drivers.tar.gz but I haven't tried this.

Additionally, as a housekeeping note, the commands above expect all files to be downloaded and untared in the same working directory.

All in all this is the crux of what was necessary for me to get the USB support running on Arch.

Sorry for the somewhat fragmented description, but hopefully this allows others to get this great tool for linux users running on the post 2.6.23 kernels.

Happy Hardware Hacking!!!

Update 2010-08-02

Comments in the forum thread announcing this wiki entry make reference to the page:

This is the upstream source for non-proprietary Xilinx USB drivers using libusb. This is now the Xilinx recommended linux usb interface and is shipped with new versions of Xilinx ISE WebPack.

Per a note on the rmdir.de website, newer versions of udev no longer support the older syntax of the /etc/udev/rules.d/xusbdfwu.rules file:

* 2010-03-15: If you are using newer udev-versions (like the version included in Debian Squeeze and Ubuntu 9.10), then the file /etc/udev/rules.d/xusbdfwu.rules is incompatible with this udev version. The effect of this is that the cable-firmware gets never loaded and the cable led never lights up.
To fix this, run the following command as root:
sed -i -e 's/TEMPNODE/tempnode/' -e 's/SYSFS/ATTRS/g' -e 's/BUS/SUBSYSTEMS/' /etc/udev/rules.d/xusbdfwu.rules
You may have to reboot for this change to take effect.

I didn't require a reboot for this patch to take affect while running:

Update 2012-04-26

I had a problem with PlanAhead software wich is based on Java, there is non-rendered window. It appears that this problem is a re-manifestation of the Java bug, which was meant to have been fixed in an early version of Java 1.6. Using MToolkit makes the workaroud: