Xilinx ISE WebPACKのソースを表示

[[Category:電子設計自動化]]
[[en:Xilinx ISE WebPACK]]
Xilinx ISE WebPACK は完全な FPGA/CPLD プログラマブルロジックデザインスイートです:
* 回路図キャプチャまたは Verilog/VHDL によるプログラマブルロジックの設計
* 特定のロジックの合成と配置配線による様々な Xilinx FPGA と CPLD
* ファンクショナル (振る舞い) シミュレーションと (配置配線後の) タイミングシミュレーション
* 通信ケーブルによる対象機器への設定データのダウンロード

ISE WebPACK の開発は [[Xilinx Vivado]] ができたことで停止していますが、新しいスイートでサポートされていない古いデバイスの開発には有用です。

Arch Linux は公式サポートされているディストリビューションではありませんが、多くの機能は Arch Linux で動作します。

== 必須要件 ==

=== ISE WebPACK のダウンロード ===
Xilinx ISE WebPACK は再配布が許可されていないプロプライエタリライセンスでリリースされているフリーソフトウェアです。[http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/design-tools.html 公式のダウンロードページ] からデータをダウンロードできます。

=== 依存パッケージ ===
ISE Webpack に含まれているツールの一部 (やインストーラー) は {{AUR|ncurses5-compat-libs}} に依存しています。さらに、他のツール (FPGA エディタなど) は {{Pkg|libstdc++5}}, {{Pkg|openmotif}}, {{Pkg|xorg-fonts-75dpi}}, {{Pkg|xorg-fonts-100dpi}} を必要とします [https://forums.xilinx.com/t5/General-Technical-Discussion/Xilinx-issues-on-Linux/td-p/194576]。

組み込み ARM コア (Xilinx Zynq SoC デバイスなど) 用にソフトウェアを開発する場合、Xilinx Embedded Development Kit (EDK) にバンドルされている GCC クロスコンパイラをインストールすることになります。このコンパイラは {{Pkg|glibc}} と {{Pkg|ncurses}} パッケージを必要とします。64ビットの Arch 環境の場合、[[multilib]] リポジトリの {{Pkg|lib32-glibc}} と [[AUR]] の {{AUR|lib32-ncurses5-compat-libs}} パッケージをインストールする必要があります。

=== デフォルトシェル ===
インストール時に、埋め込みプロセッサの Mentor CodeSourcery ツールチェインを Xilinx ツールと一緒にインストールすることができます。デフォルトのシェルが [[dash]] に設定されている場合、このインストールは何も出力をしないで失敗します。{{ic|/usr/bin/sh}} が {{ic|/usr/bin/bash}} になっていることを確認してください。

次のコマンドを実行することで確認できます:
 $ ls -l /usr/bin/sh

以下のように出力された場合:
 {{ic|lrwxrwxrwx 1 root root 15 13 Mar 06:47 /usr/bin/sh -> bash}}
{{ic|/usr/bin/sh}} は {{ic|/usr/bin/bash}} になっています (Arch Linux でのデフォルト)。

出力が異なる場合、{{ic|/usr/bin/sh}} を bash にリンクしてください:
 # ln -sfT bash /usr/bin/sh

== インストール ==
=== AUR からインストール ===
{{AUR|xilinx-ise}} パッケージをインストールしてください。ビルドを開始する前に {{ic|PKGBUILD}} と同じフォルダにインストールデータが含まれた tarball を配置する必要があります。

=== 手動インストール ===
{{Note|以下のインストール方法で動作するのを確認したのは Xilinx ISE 14.7 で、動的ライブラリの修正が必要です。}}

インストールデータを含む tarball を展開してください:
 $ tar -xvf Xilinx_ISE_DS_Lin_14.7_1015_1.tar

ISE デザインツールインストーラは Qt アプリケーションです。KDE デスクトップ環境を使っている場合、インストーラは "Oxygen" ウィジェットテーマをロードしようとしますが、Xilinx ISE デザインツールに付属している Qt フレームワークが古いために失敗します。インストーラを実行する前に {{ic|QT_PLUGIN_PATH}} 環境変数を削除する必要があります:
 $ unset QT_PLUGIN_PATH

それから、ISE デザインツールをインストールしてください:
 $ cd Xilinx_ISE_DS_Lin_14.7_1015_1
 $ ./xsetup

指示に従って ISE をインストールしてください。デフォルトで、アプリケーションは {{ic|/opt/Xilinx/}} にインストールされるため、このディレクトリに書き込みを行う権限がインストーラを実行するユーザーにあることを確認してください。

インストール中、"Install Cable Drivers" のオプションのチェックを外して下さい。チェックしたままにするとインストール中にエラーが発生します。

=== ISE デザインツールの起動 ===
ISE デザインツールには環境変数 (主に {{ic|PATH}} と {{ic|LD_LIBRARY_PATH}}) を変更するシェルスクリプトが含まれています。ISE ツールを起動する前にこのスクリプトを source する必要があります:
 $ source /opt/Xilinx/14.7/ISE_DS/settings64.sh
また、32ビット環境の場合:
 $ source /opt/Xilinx/14.7/ISE_DS/settings32.sh

スクリプトを読み込むことで、ISE デザインツールに {{ic|PATH}} が通るのでツールの名前をターミナルに入力することで起動できます (例: {{ic|ise}}, {{ic|planAhead}}, {{ic|xsdk}}, ...)。

==== デスクトップアイコンによる起動 ====
{{ic|/usr/share/applications/}} に[[デスクトップエントリ]]を作成する方法でも起動できます。

{{hc|/usr/share/applications/ise.desktop|2=
#!/usr/bin/env xdg-open
[Desktop Entry]
Version=1.0
Type=Application
Name=Xilinx ISE
Exec=sh -c "unset LANG && unset QT_PLUGIN_PATH && source /opt/Xilinx/14.7/ISE_DS/settings64.sh && ise"
Icon=/opt/Xilinx/14.7/ISE_DS/ISE/data/images/pn-ise.png
Categories=Development;
Comment=Xilinx ISE
StartupWMClass=_pn
}}

ファイルを作成したら、ホームのデスクトップフォルダ ({{ic|~/Desktop}}) に上記のファイルをコピーしてデスクトップから ISE ツールを起動できます。

=== ライセンスのインストール ===
Xilinx の [http://www.xilinx.com/getlicense/ Licensing Site] から WebPACK のライセンスをリクエストすると、ライセンスファイルがメールで届きます。このファイルは Xilinx License Manager でインポートすることができます (ターミナルから {{ic|xlcm -manage}} を実行)。

また、{{ic|~/.Xilinx}} や {{ic|/opt/Xilinx/14.7/ISE_DS/ISE/coregen/core_licenses}} ディレクトリにファイルをコピーするだけでもライセンスをインポートできます。

=== ノードロックライセンス ===
Arch Linux はデフォルトで systemd の [[ネットワーク設定#デバイス名|Predictable Network Interface Names]] を使っています。そのためシステム上のネットワークインターフェイスの名前は "eth0" や "eth1" などにはなりません。

しかし、Xilinx License Manager はそのような名前を検索してシステムの MAC アドレスを確認します。そして、ノードロックライセンスにその MAC アドレスが使われます。ノードロックライセンスが必要な場合、この機能を無効にしてネットワークインターフェイスの命名規則をカーネルによる名前に戻して、ライセンスを取得した NIC の名前を固定する必要があります。[[ネットワーク設定#デバイス名の変更]]に [[udev]] ルールを作成して設定する方法が書かれています。

== インストール後の設定 ==
インストールした後、Xilinx からは公式にサポートされていない Linux ディストリビューションで Xilinx ツールを動かすことによる問題を回避するために手動で設定が必要になります。いくつかのフィックスは [http://zedboard.org/content/ise-142-bug-reports このフォーラムポスト] から引用しています。

=== 動的ライブラリの修正 (libstdc++.so) ===
{{Note|以下の修正は AUR パッケージでは初めから行われています。}}

ISE ツールは古いバージョンの libstdc++.so ライブラリを使っているため、Xilinx Microprocessor Debugger を使用した時にセグメンテーションフォルトが発生することがあり、oxygen-gtk テーマが使用できなくなります。この古いバージョンはインストールツリー内の2つのディレクトリに含まれています: {{ic|/opt/Xilinx/14.7/ISE_DS/ISE/lib/lin64/}} と {{ic|/opt/Xilinx/14.7/ISE_DS/common/lib/lin64}}。Arch の新しい libstdc++ を使用するには、元のファイルの名前を変更または削除して、シンボリックリンクで置き換えてください:
 $ cd /opt/Xilinx/14.7/ISE_DS/ISE/lib/lin64/
 $ mv libstdc++.so libstdc++.so.bak
 $ mv libstdc++.so.6 libstdc++.so.6.bak
 $ mv libstdc++.so.6.0.8 libstdc++.so.6.0.8.bak
 $ ln -s /usr/lib/libstdc++.so
 $ ln -s libstdc++.so libstdc++.so.6
 $ ln -s libstdc++.so libstdc++.so.6.0.8

上記の作業は {{ic|/opt/Xilinx/14.7/ISE_DS/common/lib/lin64}} ディレクトリでも行って下さい。

=== Digilent USB-JTAG ドライバー ===
Xilinx デザインツールから Digilent Adept USB-JTAG アダプタ ([http://www.zedboard.org ZedBoard] のオンボード JTAG アダプタなど) を使うには、Digilent [http://store.digilentinc.com/digilent-adept-2-download-only/ Adept Runtime] と [http://store.digilentinc.com/digilent-plugin-for-xilinx-tools-download-only/ Plugin] をインストールする必要があります。

先に [[Arch User Repository]] から {{AUR|fxload}} をインストールしてください。

Digilent Adept Runtime をインストールするには、[[Arch User Repository]] から {{AUR|digilent.adept.runtime}} をビルド・インストールするのを推奨します。

さらに、{{AUR|digilent.adept.utilities}} をインストールすることでボードの設定が楽になります。

Digilent プラグインをインストールするには、2つのファイルを ISE プラグインディレクトリにコピーする必要があります。root で以下のコマンドを実行して下さい:
 $ mkdir -p /opt/Xilinx/14.7/ISE_DS/ISE/lib/lin64/plugins/Digilent/libCseDigilent
 $ cd /opt/Xilinx/14.7/ISE_DS/ISE/bin/lin64/digilent/libCseDigilent_2.4.4-x86_64/lin64/14.1/libCseDigilent
 $ cp libCseDigilent.{so,xml} /opt/Xilinx/14.7/ISE_DS/ISE/lib/lin64/plugins/Digilent/libCseDigilent
 $ chmod -x /opt/Xilinx/14.7/ISE_DS/ISE/lib/lin64/plugins/Digilent/libCseDigilent/libCseDigilent.xml

最後に、Digilent USB-JTAG アダプタにアクセスするユーザーを "uucp" グループに追加してください。

次のコマンドで JTAG アダプタの USB Vendor/Product ID を確認して:
You may have to add the USB Vendor/Product IDs of your JTAG adapter which can be found with 
 $ lsusb | grep Xilinx
{{ic|/etc/udev/rules.d/20-digilent.rules}} の udev ルールに追加してください:
 SUBSYSTEM=="usb", ATTRS{idVendor}=="xxxx", ATTRS{idProduct}=="xxxx", GROUP="users", MODE="666"

それでも動作しない場合、[http://www.george-smart.co.uk/wiki/Xilinx_JTAG_Linux Xilinx_JTAG_Linux] を読んで下さい。magic git リポジトリが役に立ちます。

=== Xilinx Platform Cable USB-JTAG ドライバー ===

先に [[Arch User Repository]] から {{AUR|fxload}} または {{AUR|fxload-libusb}} をインストールしてください。ソースからドライバーをビルドする必要があります (git などをインストールする必要があり、足りていないと make がエラーメッセージを表示します):

 $ cd /opt/Xilinx
 $ sudo git clone git://git.zerfleddert.de/usb-driver
 $ cd usb-driver/
 $ sudo make

64ビット環境で32ビット版の ISE を使う場合、"lib32" を make してください:

 $ sudo make lib32

それからドライバーをインストールしてください (14.7 はあなたの使用しているバージョンに置き換えてください):

 $ ./setup_pcusb /opt/Xilinx/14.7/ISE_DS/ISE/

古いバージョンの場合:

 $ ./setup_pcusb /opt/Xilinx/10.x/ISE/

新しいバージョンの fxload ({{AUR|fxload-libusb}}) では、{{ic|/etc/udev/rules.d/xusbdfwu.rules}} ファイルを以下のように変更する必要があります:

{{hc|$ /etc/udev/rules.d/xusbdfwu.rules|<nowiki>
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="03fd", ATTRS{idProduct}=="0008", MODE="666"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="03fd", ATTRS{idProduct}=="0007", RUN+="/usr/bin/fxload-libusb -t fx2 -I /usr/share/xusbdfwu.hex -d 03fd:0007"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="03fd", ATTRS{idProduct}=="0009", RUN+="/usr/bin/fxload-libusb -t fx2 -I /usr/share/xusb_xup.hex -d 03fd:0009"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="03fd", ATTRS{idProduct}=="000d", RUN+="/usr/bin/fxload-libusb -t fx2 -I /usr/share/xusb_emb.hex -d 03fd:000d"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="03fd", ATTRS{idProduct}=="000f", RUN+="/usr/bin/fxload-libusb -t fx2 -I /usr/share/xusb_xlp.hex -d 03fd:000f"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="03fd", ATTRS{idProduct}=="0013", RUN+="/usr/bin/fxload-libusb -t fx2 -I /usr/share/xusb_xp2.hex -d 03fd:0013"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="03fd", ATTRS{idProduct}=="0015", RUN+="/usr/bin/fxload-libusb -t fx2 -I /usr/share/xusb_xse.hex -d 03fd:0015"
</nowiki>}}

コマンドを実行すると、udev ルールが作成されます。udev ルールをリロードすることで変更をすぐに適用できます:

 $ sudo udevadm control --reload-rules

ドライバーが正しくインストールされ udev ルールが機能すれば、状態 LED がオンになります (VREF PIN の電圧によって色は緑あるいは赤になります)。

{{Note|以下の設定は Xilinx ISE のバージョンが 11.1 未満の場合にのみ必要です。}}

古いバージョンでは、iMPACT が適切なドライバーをロードしません (windrvr6 ドライバーが使用されます)。{{ic|LD_PRELOAD}} 環境変数を設定して libusb ドライバーを iMPACT にロードさせることで解決できます:

 $ export LD_PRELOAD=/opt/Xilinx/usb-driver/libusb-driver.so

=== ロケールの問題 ===
PlanAhead は小数点に '.' 以外のリテラルを使用するロケールを嫌います (例えばドイツ語は ',' を使います)。PlanAhead を実行する前に次のコマンドを実行して下さい:
 $ unset LANG

=== PlanAhead でセグメンテーションフォルト ===
PlanAhead を起動して .ucf ファイルを生成すると、セグメンテーションフォルトが発生することがあります。この問題は前のトピックと関係ありません。ISE コンソールは以下のように表示します:
 "/opt/Xilinx/14.7/ISE_DS/PlanAhead/bin/rdiArgs.sh: line 64: 14275 Segmentation fault      $RDI_PROG $*"
[http://forums.xilinx.com/t5/Installation-and-Licensing/RHEL5-64-bit-ISE-13-1-PlanAhead-launch-from-w-in-ISE-fails/td-p/148624/page/2 こちら] に記述されているようにバンドルされている JRE が問題の原因です。この問題を修正するには、OpenJDK の libjvm.so から Xilinx のインストールディレクトリにシンボリックリンクを作成してください。
 # cd /opt/Xilinx/14.7/ISE_DS/PlanAhead/tps/lnx64/jre/lib/amd64/server
 # mv libjvm.so{,-orig}
 # ln -s /usr/lib/jvm/java-7-openjdk/jre/lib/amd64/server/libjvm.so

=== GNU make ===
XSDK looks for the {{ic|gmake}} executable, which is not present in Arch Linux by default. Create a symlink somewhere in your path, e.g.
 $ ln -s /usr/bin/make /home/<user>/bin/gmake

Make sure this directory is in your PATH variable.

=== KDE の中から Xilinx ツールを実行 ===
KDE by default defines the QT_PLUGIN_PATH shell variable. Some of the Xilinx ISE tools (ISE, Impact, XPS) are Qt applications, which means that they will search for Qt plugins in the locations defined by this shell variable.

Because the Xilinx tools are compiled against and ship with an older version of the Qt framework which cannot use these plugins, they will crash when launched with this environment variable present.

To fix this issue, run the following command before launching the tools:

 $ unset QT_PLUGIN_PATH

=== CORE Generator でコアの作成ができない ===
ときどき、CORE Generator がコアの作成に失敗して以下のような出力をすることがあります:

 ERROR:sim - Unable to evaluate Tcl file:
    /opt/Xilinx/14.7/ISE_DS/ISE/coregen/ip/xilinx/primary/com/xilinx/ip/clk_wiz_v3_6/generate/run_legacy_tcl_flow.tcl
 ERROR:sim - Failed executing Tcl generator.

この場合、{{ic|_JAVA_OPTIONS}} 環境変数が設定されていないことを確認してください。次のコマンドで coregen を実行した場合:

 $ source /opt/Xilinx/14.7/ISE_DS/settings64.sh && coregen

"unset _JAVA_OPTIONS" を付ける必要があります:

 $ unset _JAVA_OPTIONS && source /opt/Xilinx/14.7/ISE_DS/settings64.sh && coregen