インストール - Xilinx ISEのソースを表示

== 概要 ==
ここでは、SUSEにXilinx ISEをインストールする手順を記載する。<br>
Xilinx ISEのインストールは簡単であるが、Platform USB Cable IIおよびCable IVのドライバのインストールは複雑である。<br>
<br>
他のLinuxディストリビューションや他のISE / Vivadoのバージョンも、このページに沿ってインストールできる場合がある。<br>
Xinlix ISEの使用方法、ライセンスの管理方法、HDLの記述方法については説明しない。<br>
<br><br>

== 依存関係のライブラリのインストール ==
以下の依存関係のライブラリをインストールする。<br>
 sudo zypper install libncurses5
<br><br>

== Xilinx ISEのインストール ==
スーパーユーザになり、Xilinx ISEが存在するメディアに移動して、以下のコマンドを実行する。<br>
 su
 ./xsetup
<br>
インストール画面が起動するので、画面の指示に従ってインストールを行う。<br>
Platform USB Cable IIのドライバのインストールを求められたら、ドライバのインストールを選択する。<br>
<br>
Xilinx ISEに必要な環境変数について通知するメッセージは無視すること。(詳細は、最後のセクションの"Xilinx ISEの起動スクリプトの設定"を参照すること)<br>
また、インストール手順の最後に表示される、Platform USBのドライバのインストールが失敗したというメッセージは無視する。後でインストールおよび設定を行う。<br>
<br>
Xilinx ISEのインストール完了後、以下のディレクトリにアクセスする。<br>
(ここには、ファームウェアファイルが存在する)<br>
 cd /<Xilinx ISEのインストールディレクトリ>/14.7/ISE_DS/common/bin/lin64/
<br>
ファームウェアファイルを/usr/shareディレクトリにコピーする。<br>
 sudo cp *.hex /usr/share
<br>
xusbdfwu.rulesファイルを/etc/udev/rules.dディレクトリにコピーする。<br>
 sudo cp xusbdfwu.rules /etc/udev/rules.d/
<br>
xusbdfwu.rulesファイルを以下のように編集(文字を置き換える)する。<br>
 $TEMPNODE → $tempnode
 BUS → SUBSYSTEMS
 SYSFS → ATTRS
<br>
以下のコマンドを実行して、文字の置換を行うこともできる。(シェルスクリプトにしてもよい)<br>
 sudo sed -e "s/$TEMPNODE/$tempnode/g" /etc/udev/rules.d/xusbdfwu.rules
 sudo sed -e "s/BUS/SUBSYSTEMS/g" /etc/udev/rules.d/xusbdfwu.rules
 sudo sed -e "s/SYSFS/ATTRS/g" /etc/udev/rules.d/xusbdfwu.rules
<br>
[[ファイル:Xilinx ISE Setup 1.png|フレームなし|中央]]
<br>
恐らく、次の設定は不要であるが、念の為に記載しておく。<br>
 sudo cp /usr/lib/libstdc++.so.6 /<Xilinx ISEのインストールディレクトリ>/14.7/ISE_DS/common/lib/lin64/
 または
 sudo ln -s /usr/lib/libstdc++.so.6 /<Xilinx ISEのインストールディレクトリ>/14.7/ISE_DS/common/lib/lin/libstc++.so.6
<br><br>

== Platform Cable USB IIの接続確認 ==
# Xinlix ISEが起動していないことを確認する。
# Platform Cable USB IIがLinuxホストに接続されていないことを確認する。
# fxload、make、gcc、libusb-develをインストールするため、以下のコマンドを入力する。
#: sudo zypper install fxload make gcc  libpng12-0 libusb-compat-devel
# SUSEを再起動する。
# Platform Cable USB IIをLinuxホストに接続すると、Platform Cable USB IIのLEDが黄色に点灯する。<br>(USB延長コードは電源に悪影響を与える可能性があるため、推奨しない)
<br>
'''LEDが点灯しない場合'''<br>
もし、LEDが点灯しない場合は、次のコマンドを実行する。<br>
この時、hex拡張子のファイルが多く出力されるはずである。<br>
 ls -l /usr/share/*.hex
<br>
もし、そのようなファイルが出力されない場合は、再度Xilinx ISEをインストールする。(インストール時に、Platform Cable USB IIドライバが選択されていることを確認する)<br>
<br>
それでもPlatform Cable USB IIのLEDが黄色に点灯しない場合は、コンソールを開いて以下のコマンドを実行する。<br>
 lsusb | grep Xilinx
<br>
'''ファームウェアのアップロード'''<br>
Platform Cable USB IIへのファームウェアのアップロードが失敗した場合、次のような行が出力される。<br>
これは、Platform Cable USB IIは認識されていることを示す。<br>
 Bus 005 Device 004: ID 03fd:<span style="color: #A00000>0013</span> Xilinx, Inc. Platform Cable USB II
<br>
ファームウェアのアップロードが成功した場合、出力は次のようになる。<br>
ここで重要なのは、上記や下記の赤で記載した番号である。下記の0008は、Platform Cable USB IIのファームウェアが正しくロードされたことを示している。<br>
 Bus 005 Device 004: ID 03fd:<span style="color: #A00000>0008</span> Xilinx, Inc. Platform Cable USB II
<br>
次に、/etc/udev/rules.dディレクトリに移動して、以下の内容のファイルを作成する。<br>
 sudo vi /etc/udev/rules.d/libusb-driver.rules
<br>
 # /etc/udev/rules.d/libusb-driver.rulesファイル
 ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="03fd", MODE="666"
<br>
設定を反映させるため、SUSEを再起動する。<br>
<br><br>

== Platform Cable USB IIのドライバのインストール ==
# ホームディレクトリにISE-USB_Driverディレクトリを作成して、以下のWebサイトからPlatform Cable USB IIのドライバのソースコードをダウンロードする。
#: http://git.zerfleddert.de/cgi-bin/gitweb.cgi/usb-driver?a=snapshot;h=HEAD;sf=tgz<br>または<br>http://www.rmdir.de/~michael/xilinx/
#: <br><u>'''※注意'''</u><br>usb-driver-HEAD.tar.gzファイルにアクセスできない場合は、Xilinxへメールで連絡してファイルを送信してもらうことができる。
# ダウンロードしたファイルを解凍するため、以下のコマンドを実行する。
#: gunzip usb-driver-HEAD.tar.gz && tar -xf usb-driver-HEAD.tar
# 解凍したusb-driverディレクトリで、ソースコードをコンパイルするため、以下のコマンドを実行する。
#: make -j 8
# libusb-driver.soが生成されたか確認する。
#: libusb-driver.so
# もし存在するなら、Platform Cable USB IIのドライバが使用できるようになる。
<br><br>

== Xilinx ISEの起動スクリプトの設定 ==
Xilinx ISEはいくつかの環境変数を必要とするため、シェルスクリプトを使用して初期化することが好ましい。<br>
なお、このシェルスクリプトは、一般ユーザで実行する。<br>
<br>
# Xilinx ISEのインストールディレクトリに、ISE-Start.shファイルを作成する。<br>以下の内容を、ISE-Start.shファイルに記述する。
#: <code>sudo vi /opt/Xilinx/14.7/ISE_DS/ISE-Start.sh</code>
#: <br>
#: <code>#!/bin/sh</code>
#: <code>source /<Xilinx ISEのインストールディレクトリ>/14.7/ISE_DS/settings64.sh # uncomment if required</code>
#: <code>#source /opt/Xilinx/10.1/ISE/settings32.sh # comment if required</code>
#: <code>#source /opt/Xilinx/11.1/ISE/settings32.sh # uncomment if required</code>
#: <code>export LD_PRELOAD=/<上記のセクションでコンパイルしたlibusb-driver.soが存在するディレクトリ>/libusb-driver.so</code>
#: <code>ise # comment if neccessary<br>#impact # uncomment if neccessary</code>
#: <code>exit</code>
# ISE-Start.shファイルに実行権限を与える。
#: sudo chmod 755 /opt/Xilinx/14.7/ISE_DS/ISE-Start.sh
# デスクトップにISE-Start.shファイルのランチャーを作成する。<br>このアイコンを押下することで、Xilinx ISEが起動する。<br>また、Xilinx ISEのライセンスとPlatform Cable USB IIの設定を行う。これで、Platform Cable USB IIまたはParallel IVを使用する準備ができる。
# また、以下のようにデスクトップエントリファイルを作成するほうがより良い。
 # Xilinx_ISE-14_7.desktopファイル
 
 [Desktop Entry]
 Type=Application
 Name=Xilinx ISE 14.7
 GenericName=Xilinx ISE
 Comment=FPGA Design
 Exec="/home/ユーザ名/Xilinx/ISE-Start.sh" %F
 Icon=/home/ユーザ名/Xilinx/Xilinx_ISE.png
 StartupWMClass=Xilinx_ISE
 Terminal=false
 Categories=Development;Xilinx;
<br>
<u>'''※注意 1'''</u><br>
'''使用しているXilinx ISEのバージョンおよびシステムアーキテクチャ(32bitまたは64bit)に応じて、sourceで始まる行をコメントまたはコメント解除する。'''<br>
<br>
<u>'''※注意 2'''</u><br>
'''Impactを直接実行する場合は、iseで始まる行をコメントアウトして、Impactで始まる行をコメント解除する。'''<br>
<br><br>

== Digilentプラグインのインストール ==
Digilentプラグインを使用すると、Xilinxの開発環境において、Digilent USB-JTAG FPGAコンフィギュレーション回路を直接使用できる。
Impact、ChipScope Pro、EDK Xilinx Microprocessor Debugger(XMD)、DK Xilinx Software Development Kit(SDK)がサポートされている。
<br>
必須環境において、Digilent Adept Runtime 2.9以降が必要となる。<br>
<br>
このセクションでは、Digilentプラグインのインストール手順を記載する。<br>
<br>
Digilentプラグインのダウンロードは、以下のWebサイトからダウンロードする。<br>
https://store.digilentinc.com/digilent-plugin-for-xilinx-tools-download-only/
<br>
ダウンロードしたDigilentプラグインを解凍して、以下のディレクトリに移動する。<br>
 cd libCseDigilent_<バージョン名>-x86_64/ISE14x/plugin
<br>
Xilinx ISEのインストールディレクトリにある古いDigilentプラグインのバックアップを取得する。<br>
 cd  /opt/<Xilinx ISEのインストールディレクトリ>/14.7/ISE_DS/ISE/lib/lin64/plugins/Digilent/libCseDigilent
 sudo mv libCseDigilent.so libCseDigilent_org.so
 sudo mv libCseDigilent.xml libCseDigilent_org.xml
<br>
新しい2つのプラグインを、Xilinx ISEのインストールディレクトリにコピーする。<br>
 cd libCseDigilent_<バージョン名>-x86_64/ISE14x/plugin
 sudo cp libCseDigilent.so libCseDigilent.xml /opt/<Xilinx ISEのインストールディレクトリ>/14.7/ISE_DS/ISE/lib/lin64/plugins/Digilent/libCseDigilent
<br><br>

== Adeptランタイムのインストール ==
Digilent製品を使用する場合、Adeptランタイムのインストールが必要である。<br>
このセクションでは、Adeptランタイムのインストール手順を記載する。<br>
<br>
Adeptランタイムは、以下のWebサイトからダウンロードする。<br>
https://store.digilentinc.com/digilent-plugin-for-xilinx-tools-download-only/
<br>
==== 自動インストール ====
以前、Adeptランタイムをインストールしている場合、既に/etc/ld.so.conf.d/digilent-adept.confファイルが存在している可能性がある。<br>
もし、古いファイルが含まれている場合、新しいAdeptランタイムをインストールする前に、手動で削除する必要がある。<br>
<br>
基本的なインストールでは、install.shファイルを実行する。<br>
ほとんどの環境において、必要な全てのコンポーネントをインストールすることができる。<br>
 sudo ./install.sh
<br>
もし、何らかの理由でインストールできない場合やインストールプロセスをより細かく制御する場合は、<br>
各コンポーネントを手動でインストールする方法を、以下に記載する。<br>
<br>
==== Adept共有ライブラリ ====
Degilentライブラリのランタイムは複数の共有ライブラリで構成されている。<br>
これらのライブラリは/lib64ディレクトリにある。<br>
<br>
該当するディレクトリの内容は、ランタイムがインストールされているディストリビューションに適した場所にコピーする必要がある。<br>
/usr/local/lib64/digilent/adeptと/usr/lib64/digilent/adeptを推奨する。<br>
<br>
以下のコマンドを実行して、Adept共有ライブラリをインストールする。<br>
 sudo mkdir -p /usr/lib64/digilent/adept
 sudo cp -fd lib/* /usr/lib64/digilent/adept
 sudo chmod -R 755 /usr/lib64/digilent/adept
<br>
==== ダイナミックローダ設定ファイル(digilent-adept-libraries.conf) ====
Adeptランタイムを使用するアプリケーションがダイナミックローダを実行するためには、ランタイムが構成する共有ライブラリを見つける必要がある。<br>
<br>
digilent-adept-libraries.confファイルには、x86およびx64のランタイムのデフォルトのインストールパスが含まれている。<br>
このファイルを編集して、インストールに適したパスを含むようにする。<br>
<br>
以下のコマンドを実行して、ダイナミックローダ設定ファイルをインストールする。<br>
 sudo cp -f digilent-adept-libraries.conf /etc/ld.so.conf.d
 sudo chmod 644 /etc/ld.so.conf.d/digilent-adept-libraries.conf
<br>
次に、ダイナミックローダでキャッシュを更新する必要がある。<br>
以下のコマンドを実行して、キャッシュを強制的に更新する。<br>
 sudo /sbin/ldconfig
<br>
==== ファームウェアイメージ ====
Adeptランタイムには、ランタイムが正しく機能するために、インストールする必要のあるファームウェアイメージが含まれる。<br>
これらのイメージは、data/firmwareディレクトリにある。<br>
<br>
Adeptランタイムは、firmwareディレクトリ直下にあるDigilentディレクトリで、これらのイメージを見つけることを想定している。<br>
既知の場所に配置された構成ファイルは、Digilentディレクトリへのパスをランタイムに通知するために使用される。<br>
構成ファイルについては、「AdeptRuntimeConfigurationFile」というタイトルのセクションで説明しています。<br>
また、ディレクトリへのパスは、環境変数DIGILENT_DATA_DIRで指定することもできる。<br>
<br>
Digilentディレクトリは、ユーザの任意の場所に配置できる。<br>
一般的に、このディレクトリは/usr/share/digilent/adept/dataに配置される。<br>
例えば、Digilentディレクトリを使用する場合は、ファームウェアイメージを/usr/share/digilent/adept/data/firmwareにインストールする。<br>
<br>
以下のコマンドを実行して、ファームウェアイメージをインストールする。<br>
 sudo mkdir -p / usr / share / digilent / adept / data / firmware
 sudo cp -f data /firmware/*.HEX/usr/share/digilent/adept/data/firmware
 sudo cp -f data /firmware/*.so/usr/share/digilent/adept/data/firmware
 sudo chmod 644 /usr/share/digilent/adept/data/firmware/*.HEX
 sudo chmod 755 /usr/share/digilent/adept/data/firmware/*.so
<br><br>

__FORCETOC__
[[カテゴリ:Verilog-HDL]][[カテゴリ:SUSE]]