Xilinx USB II Cable driver under Gentoo Linux

[Petter Gustad]

I'm looking for pointers to an installation guide on how to install
the Xilinx USB II Cable driver under Gentoo Linux?

I just took a quick look at the installation script(1) and found
checks for specific releases (grep -c -i "SUSE" /proc/version) rather
than checks for functionality and features, which is a bad thing when
it comes to portability across distributions. Also a quick ./configure
and make resulted in lots of warnings and errors. Hence I wanted to
know if anybody else have walked up this path already.

I checked http://en.gentoo-wiki.com/ which seem to be down, at least I
get only a blank page.


1)https://secure.xilinx.com/webreg/clickthrough.do?cid=103670&license=RefDesLicense&filename=install_drivers.tar.gz

//Petter
--
..sig removed by request.

 

[General Schvantzkoph]

On Wed, 02 Nov 2011 14:57:07 +0100, Petter Gustad wrote:

I'm looking for pointers to an installation guide on how to install the
Xilinx USB II Cable driver under Gentoo Linux?

I just took a quick look at the installation script(1) and found checks
for specific releases (grep -c -i "SUSE" /proc/version) rather than
checks for functionality and features, which is a bad thing when it
comes to portability across distributions. Also a quick ./configure and
make resulted in lots of warnings and errors. Hence I wanted to know if
anybody else have walked up this path already.

I checked http://en.gentoo-wiki.com/ which seem to be down, at least I
get only a blank page.


1)https://secure.xilinx.com/webreg/clickthrough.do?
cid=103670&license=RefDesLicense&filename=install_drivers.tar.gz

//Petter

You don't want to use the WinDrvr that Xilinx provides, it doesn't work
for any modern kernel. Set the following variable in your shell before using chipscope or impact

setenv XIL_IMPACT_USE_LIBUSB 1

Then do the following setup (this for Redhat)

#!/bin/csh -f
yum -y install libusb libusb1 fxload
cp $XILINX/bin/lin64/*.hex /usr/share
cd /usr/lib64
ln -s libusb-1.0.so.0.0.0 libusb.so
cp setup_pcusb $XILINX/bin/lin64
setup_pcusb
xusbdfwu.rules /etc/udev/rules.d

-------------------------------
xusbdfwu.rules
# version 0003
ATTR{idVendor}=="03fd", ATTR{idProduct}=="0008", MODE="666"
SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="03fd", ATTR{idProduct}=="0007", RUN+="/sbin/fxload -v -t fx2 -I /usr/share/xusbdfwu.hex -D $tempnode"
SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="03fd", ATTR{idProduct}=="0009", RUN+="/sbin/fxload -v -t fx2 -I /usr/share/xusb_xup.hex -D $tempnode"
SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="03fd", ATTR{idProduct}=="000d", RUN+="/sbin/fxload -v -t fx2 -I /usr/share/xusb_emb.hex -D $tempnode"
SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="03fd", ATTR{idProduct}=="000f", RUN+="/sbin/fxload -v -t fx2 -I /usr/share/xusb_xlp.hex -D $tempnode"
SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="03fd", ATTR{idProduct}=="0013", RUN+="/sbin/fxload -v -t fx2 -I /usr/share/xusb_xp2.hex -D $tempnode"
SUBSYSTEM=="usb", ACTION=="add", ATTR{idVendor}=="03fd", ATTR{idProduct}=="0015", RUN+="/sbin/fxload -v -t fx2 -I /usr/share/xusb_xse.hex -D $tempnode"

-------------------------------
setup_pcusb

#!/bin/sh
# Copyright (c) 2005 Xilinx, Inc. All rights reserved.
#
# Xilinx, Inc.
# XILINX IS PROVIDING THIS DESIGN, CODE, OR INFORMATION "AS IS" AS A
# COURTESY TO YOU. BY PROVIDING THIS DESIGN, CODE, OR INFORMATION AS
# ONE POSSIBLE IMPLEMENTATION OF THIS FEATURE, APPLICATION OR
# STANDARD, XILINX IS MAKING NO REPRESENTATION THAT THIS IMPLEMENTATION
# IS FREE FROM ANY CLAIMS OF INFRINGEMENT, AND YOU ARE RESPONSIBLE
# FOR OBTAINING ANY RIGHTS YOU MAY REQUIRE FOR YOUR IMPLEMENTATION.
# XILINX EXPRESSLY DISCLAIMS ANY WARRANTY WHATSOEVER WITH RESPECT TO
# THE ADEQUACY OF THE IMPLEMENTATION, INCLUDING BUT NOT LIMITED TO
# ANY WARRANTIES OR REPRESENTATIONS THAT THIS IMPLEMENTATION IS FREE
# FROM CLAIMS OF INFRINGEMENT, IMPLIED WARRANTIES OF MERCHANTABILITY
# AND FITNESS FOR A PARTICULAR PURPOSE.
#

TP_PCUSB_HEX_FILE="xusbdfwu.hex"

TP_KERNEL_VERSION=`uname -r`
# check if udev is running on version 2.6.13* and later
TP_MAJOR_VERSION=`echo $TP_KERNEL_VERSION | cut -f 1 -d "."`
TP_MINOR_VERSION=`echo $TP_KERNEL_VERSION | cut -f 2 -d "."`
TP_MINOR_SUBVERSION=`echo $TP_KERNEL_VERSION | cut -f 3 -d "." | cut -f 1 -d "-"`

#TP_USE_UDEV="0"
#TP_UDEV_ENABLED=`ps -e | grep -c udevd`
TP_UDEV_ENABLED="1"

if [ $TP_MAJOR_VERSION = "2" ]
then
if [ $TP_MINOR_VERSION = "6" ]
then
test $TP_MINOR_SUBVERSION -ge "13"
if [ $? = "0" ]
then
if [ $TP_UDEV_ENABLED = "1" ]
then
TP_USE_UDEV="1"
fi;
fi;
fi;
fi;

# $1 - destination directory
# $2 - driver name
update_hex_file ()
{
TP_INSTALL_DRIVER="1" # default to install
#TP_DRV_SRC_PATH="/etc/hotplug/usb/xusbdfwu.fw"
TP_DRIVER_FILE=$1/$2
get_hex_file_version $TP_DRIVER_FILE
if [ $? = "1" ]
then
TP_DEST_VERSION=$TP_DRIVER_VER
TP_DRIVER_FILE=$2
get_hex_file_version $TP_DRIVER_FILE
TP_SRC_VERSION=$TP_DRIVER_VER
if [ $TP_DEST_VERSION -lt $TP_SRC_VERSION ]
then
echo "--File $TP_DRIVER_FILE is newer than the destination file."
else
echo "--File $TP_DRIVER_FILE is already updated."
TP_INSTALL_DRIVER="0"
fi;
else
echo "--Error getting file version for $TP_DRIVER_FILE."
fi;

if [ $TP_INSTALL_DRIVER = "1" ]
then
echo "--Updating $2 file."
# Copy hex file to the fw directory.
mkdir -p $1
/bin/cp -p $2 $1
fi;
}

update_usermap ()
{
TP_ID_PRESENT=`cat /etc/hotplug/usb.usermap | grep xusbdfwu | grep -i -c $1`
if [ $TP_ID_PRESENT = "0" ]
then
echo "--Adding Product ID $1 to the usermap."
echo "xusbdfwu 0x0003 0x03fd 0x$1 0x0000 0x0000 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000" >> /etc/hotplug/usb.usermap
else
echo "--Product ID $1 is already in the usermap."
fi;
}

file_exists ()
{
if [ -f $1 ]
then
echo "--File $1 exists."
return 1
else
echo "--File $1 does not exist."
return 0
fi;
}

get_hex_file_version ()
{
TP_DRIVER_VER="0000"
file_exists $1
if [ $? = "1" ]
then
TP_VERSION_STRING=`grep ":0219B900" $1`
#TP_HEX_VERSION=`expr substr $TP_VERSION_STRING 10 4`
TP_HEX_VERSION=${TP_VERSION_STRING:9:4}
TP_DRIVER_VER=`printf "%d" 0x$TP_HEX_VERSION`
echo "--File $1 version = "$TP_DRIVER_VER
return 1
else
return 0
fi;
}

# arg1 = file, arg2 = version string
get_rules_file_version ()
{
TP_DRIVER_VER="0000"
file_exists $1
if [ $? = "1" ]
then
TP_VER_STR_LINE=`cat $1 | grep "$2"`
TP_DRIVER_VER=${TP_VER_STR_LINE:10:4}
echo "--File $1 version = "$TP_DRIVER_VER
return 1
else
return 0
fi;
}

if [ $TP_USE_UDEV = "0" ]
then
update_hex_file /etc/hotplug/usb/xusbdfwu.fw xusbdfwu.hex
update_hex_file /etc/hotplug/usb/xusbdfwu.fw xusb_xlp.hex
update_hex_file /etc/hotplug/usb/xusbdfwu.fw xusb_emb.hex
update_hex_file /etc/hotplug/usb/xusbdfwu.fw xusb_xpr.hex
update_hex_file /etc/hotplug/usb/xusbdfwu.fw xusb_xup.hex
update_hex_file /etc/hotplug/usb/xusbdfwu.fw xusb_xp2.hex
update_hex_file /etc/hotplug/usb/xusbdfwu.fw xusb_xse.hex

# Copy loader script file to the usb directory.
/bin/cp -p xusbdfwu /etc/hotplug/usb
chmod 775 /etc/hotplug/usb/xusbdfwu
/bin/cp -p xusb_xlp /etc/hotplug/usb
chmod 775 /etc/hotplug/usb/xusb_xlp
/bin/cp -p xusb_emb /etc/hotplug/usb
chmod 775 /etc/hotplug/usb/xusb_emb
/bin/cp -p xusb_xpr /etc/hotplug/usb
chmod 775 /etc/hotplug/usb/xusb_xpr
/bin/cp -p xusb_xup /etc/hotplug/usb
chmod 775 /etc/hotplug/usb/xusb_xup
/bin/cp -p xusb_xp2 /etc/hotplug/usb
chmod 775 /etc/hotplug/usb/xusb_xp2
/bin/cp -p xusb_xse /etc/hotplug/usb
chmod 775 /etc/hotplug/usb/xusb_xse

# Add entries to usermap
update_usermap "0007"
update_usermap "0009"
update_usermap "000d"
update_usermap "000f"
update_usermap "0013"
update_usermap "0015"

update_usermap "0008"

else

update_hex_file /usr/share xusbdfwu.hex
update_hex_file /usr/share xusb_xlp.hex
update_hex_file /usr/share xusb_emb.hex
update_hex_file /usr/share xusb_xpr.hex
update_hex_file /usr/share xusb_xup.hex
update_hex_file /usr/share xusb_xp2.hex
update_hex_file /usr/share xusb_xse.hex

TP_INSTALL_DRIVER="1"
TP_DRIVER_FILE="/etc/udev/rules.d/xusbdfwu.rules"
get_rules_file_version $TP_DRIVER_FILE "# version"
if [ $? = "1" ]
then
TP_DEST_VERSION=$TP_DRIVER_VER
TP_DRIVER_FILE="xusbdfwu.rules"
get_rules_file_version $TP_DRIVER_FILE "# version"
TP_SRC_VERSION=$TP_DRIVER_VER
if [ $TP_DEST_VERSION -lt $TP_SRC_VERSION ]
then
echo "--File $TP_DRIVER_FILE is newer than the destination file."
else
echo "--File $TP_DRIVER_FILE is already updated."
TP_INSTALL_DRIVER="0"
fi;
else
echo "--Error getting file version for $TP_DRIVER_FILE."
fi;

if [ $TP_INSTALL_DRIVER = "1" ]
then
echo "--Updating rules file."
/bin/cp -p xusbdfwu.rules /etc/udev/rules.d
fi;
fi;

# End of file.

 

[Petter Gustad]

General Schvantzkoph <schvantzkoph@yahoo.com> writes:

You don't want to use the WinDrvr that Xilinx provides, it doesn't work
for any modern kernel. Set the following variable in your shell before using chipscope or impact

setenv XIL_IMPACT_USE_LIBUSB 1

Then do the following setup (this for Redhat)

Thank you for the script. I don't seem to have a libusb1 on Gentoo,
but I'll try to walk through the script and see if I can get it to
work.

I also noticed that there's a similar approach described at:

http://www.george-smart.co.uk/wiki/Xilinx_JTAG_Linux

But the driver fails to compile since it can't find a 32-bit ibftdi on
my 64-bit system...

//Petter
--
..sig removed by request.

 

[rndhro]

On 11/03/11 09:19, Petter Gustad wrote:

General Schvantzkoph <schvantzkoph@yahoo.com> writes:

You don't want to use the WinDrvr that Xilinx provides, it doesn't work
for any modern kernel. Set the following variable in your shell before using chipscope or impact

setenv XIL_IMPACT_USE_LIBUSB 1

Then do the following setup (this for Redhat)

If you use ISE newer than 11 you don't even have to set the
XIL_IMPACT_USE_LIBUSB variable. Just make sure you have a symlink
/lib/libusb.so to your actual libusb-[version].so file.
Then make sure you have the xusbdwfu.rules from $XILINX/ISE/bin/lin64/
at /etc/udev/rules.d/, fxload installed and the *.hex files from
$XILINX/ISE/bin/lin64/ copied to /usr/share/.

This works fine for me with Gentoo and dev-libs/libusb from portage for
any recent ISE version.

HTH

 

[Petter Gustad]

rndhro <rnd@hro.org> writes:

On 11/03/11 09:19, Petter Gustad wrote:
General Schvantzkoph <schvantzkoph@yahoo.com> writes:

You don't want to use the WinDrvr that Xilinx provides, it doesn't work
for any modern kernel. Set the following variable in your shell before using chipscope or impact

setenv XIL_IMPACT_USE_LIBUSB 1

Then do the following setup (this for Redhat)

If you use ISE newer than 11 you don't even have to set the

Thanks. I'm using v13.3i. I got it working now.

XIL_IMPACT_USE_LIBUSB variable. Just make sure you have a symlink
/lib/libusb.so to your actual libusb-[version].so file.

BTW, I don't like to replace system wide so files. I prefer to do
something like:

mkdir ~/libusb
ln -s /usr/lib/libusb-1.0.so.0.0.0 ~/libusb/libusb.so
LD_LIBRARY_PATH=~/libusb:$LD_LIBRARY_PATH impact

//Petter
--
..sig removed by request.