---
tags: David, OpenSSD, Xilinx
---

# Xilinx IDEs and Licenses


## Prerequisites

### AMD Account

大部分的檔案下載都需要先登入 AMD 帳號，所以先到 [Xilinx 官方網站](https://www.xilinx.com/)找到[註冊帳號](https://login.xilinx.com/)。

### License

參考[台大 Media IC & System Lab 文件](http://media.ee.ntu.edu.tw/courses/msoc/0_zedlab0.pdf)中的說明，到 Xilinx 官方的 [License Form](https://www.xilinx.com/member/forms/license-form.html) 取得並下載 Licenses。

:::warning
申請後還需要匯入 License，請參考安裝 Vivado 完後的說明進行 License 匯入。
:::

:::info
因為 License 會綁 Mac Address，而 OpenSSD 需要用到的 License 有試用期限，所以建議裝在能簡單修改 Mac Address 的虛擬機中，並搭配類似 [Firefox Relay](https://relay.firefox.com) 的服務申請試用版的 License。
:::

---

## TL;DR

### Xilinx Vivado 2019.1 (for Cosmos+ Hardware Development)

https://ncku365-my.sharepoint.com/:u:/g/personal/p76114016_ncku_edu_tw/Ecfjj4W1HuVAp-c9DrFum6YBU0M2CG0N_pQZfuSjBZSrpA?e=Ew1u3u

### Xilinx SDK 2019.1 (for Cosmos+ Firmware Development)

https://ncku365-my.sharepoint.com/:u:/g/personal/p76114016_ncku_edu_tw/EXbHRxE5zjZDpMyjSggsZbYBpts-Lh8oJPNNsk2fwxnJ_w?e=vAAKns

:::warning
需要用學校帳號登入才能存取
:::

---

:::warning
[OpenSSD 官方 GitHub 的專案](https://github.com/Cosmos-OpenSSD/Cosmos-plus-OpenSSD)是給 SK Hynix 的 NAND Flash 用的專案，詢問 CRZ 原廠後發現有[新版專案](https://github.com/CRZ-Technology/OpenSSD-OpenChannelSSD/)，其中 `CosmosPlus/OpenSSD
/Toshiba_NAND/` 目錄下有適用於 Toshiba 的 NAND Flash 的專案，而這個專案需要使用 Vivado 2019.1 的環境。

因此 Vivado 2019 的安裝流程待更新，但大致與舊版專案用的 Vivado 2014 的環境安裝流程相同。
:::

## Vivado Design Suite (for Cosmos+)

:::info
以下測試環境為基於 KDE 的 Kubuntu 22.04 STL
:::

### Download

到 [Vivado 的下載網站](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools/archive.html)找到並下載 2014.4 版 Vivado 的 Linux 安裝檔。

### Dependencies for Installation

在**較新版**的安裝程式中有提到 Linux 需要安裝額外 library：

> 

而參考官方對相關討論的說明：

- https://support.xilinx.com/s/question/0D52E00006iHjbcSAC/vivado-20211-installation-hangs-at-generating-installed-device-list?language=en_US
- https://support.xilinx.com/s/question/0D52E00006hpRxQSAU/vivado-20202-installation-stuck-at-generating-installed-device-list-on-ubuntu-2004lts?language=en_US

可以知道需要的 library 有以下這些：

$ sudo apt install libncurses5 libtinfo5 libncurses5-dev libncursesw5-dev 

而雖然 2014.4 版的安裝說明沒有提到，但若是缺少這些 library 的話，安裝時會卡在 **generating installed devices list** 的地方。

:::warning
Ubuntu 14.04 LTS 不用特別裝這些 Library，其他 Ubuntu 版本待測

- Ubuntu 20.04 LTS 安裝 Vivado 2019.1 也需要安裝這些 library
:::

### Install Vivado Design Suite

進到 Vivado 目錄下後依據[官方文件中的說明](https://docs.xilinx.com/api/khub/documents/k3xe5X5jzJnWJArJ~vMiAQ/content?Ft-Calling-App=ft%2Fturnkey-portal&Ft-Calling-App-Version=3.11.41&filename=ug973-vivado-release-notes-install-license.pdf#G4.366396)：

> The cable is officially supported on the 32-bit and 64-bit versions of the following operating systems: Windows-7, Red Hat Linux Enterprise, and SUSE Linux Enterprise 11. Additional platform specific notes are as follows:
>
> - Root privileges are required

以 root 權限執行安裝程式：

$ cd /path/to/your/vivado-for-linux
$ sudo ./xsetup

在選擇 Vivado Edition 時選擇 System Edition：


並在安裝配件的地方勾選 **Software Development Kit** 跟 **Install Cable Drivers** 兩項。


:::success
若只要跑 Hardware 部份、沒有要執行 Firmware 的話，可以不用勾選 Software Development Kit (Xilinx SDK)。
:::

:::warning
Devices 或許可以根據 [Cosmos+ HW Spec](http://www.openssd-project.org/cosmospl/overview/) 取消勾選部份 Device，待測試。
:::

接著選擇要安裝哪裡、是否要建立桌面捷徑：


:::danger
這邊是以 root 權限安裝，所以桌面捷徑也只是建立給 root 而不是當前 user，所以可以不用打勾。若是打勾的話，雖然依然可以正常安裝，但若查看執行 `$ sudo ./xsetup` 時印出的 log file 的話，會發現其實桌面捷徑會建立失敗：

$ sudo cat /path/to/your/log-file | grep -i fail
2022-07-09 00:09:50,853 DEBUG: com.xilinx.installer.shortcuts.lin.LinuxShortcutFile:? - Failed creating the shortcut folder file /root/Desktop/Vivado 2014.4.desktop
2022-07-09 00:09:50,854 DEBUG: com.xilinx.installer.shortcuts.lin.LinuxShortcutFile:? - Failed creating the shortcut folder file /root/.local/share/desktop-directories/Xilinx Design Tools_1657296590854.directory
2022-07-09 00:09:50,855 DEBUG: com.xilinx.installer.shortcuts.lin.LinuxShortcutFile:? - Failed creating the shortcut folder file /root/.local/share/desktop-directories/Vivado 2014.4_1657296590855.directory
2022-07-09 00:09:50,855 DEBUG: com.xilinx.installer.shortcuts.lin.LinuxShortcutFile:? - Failed creating the shortcut folder file /root/.local/share/applications/Vivado 2014.4_1657296590855.desktop
...

:::

然後按下一步檢查安裝項目與目標路徑：


沒問題的話就可以按 Install 等它跑完。

### Load License

安裝到最後時應會跳出 Vivado License Manager (VLM) 的畫面：


這邊先忽略它，直接關閉該視窗並結束安裝。

### Launch IDE

實際上 **Xilinx SDK** 的執行檔路徑是前面安裝指定目錄下的 `SDK/2014.4/bin/xsdk`，但並不用每次都跑到 `bin` 目錄下找對應的執行檔，根據 [Xilinx SDK 2014.4 的官方文件](https://docs.xilinx.com/api/khub/documents/k3xe5X5jzJnWJArJ~vMiAQ/content?Ft-Calling-App=ft%2Fturnkey-portal&Ft-Calling-App-Version=3.11.41&filename=ug973-vivado-release-notes-install-license.pdf#G5.365616)以及[某篇問題討論中官方的回答](https://support.xilinx.com/s/question/0D52E00006hpZjGSAU/unable-to-create-sdk-application-project-error-while-loading-libsdkjappgendll?language=en_US)，可以在 SDK 目錄下透過 `$ source ./settings64.sh` 來設定所需的環境變數，然後就可以直接輸入 `xsdk` 或是 `vlm` 啟動 SDK 或是 License Manager：

$ pwd          
/home/hsi/Softwares/Xilinx/SDK/2014.4
$ source ./settings64.sh
$ xsdk

:::danger
但也可以直接執行 `SDK/2014.4/bin/` 下的執行檔，目前尚未發現是否會造成問題。
:::

---

## ISE Design Suite (for Cosmos)

:::warning
除非要用舊的平台（Cosmos），否則這個部份可以跳過
:::

### Download

- Xilinx ISE

到 [Xilinx ISE 的下載頁面](https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools/archive-ise.html)找到 `14.7 Windows 10`，接著下載 `14.7 Window 10 (TAR/GZIP - 15.52 GB)` 並解壓縮。

- VirtualBox

到 [Oracle VirtualBox 下載頁面](https://www.virtualbox.org/wiki/Linux_Downloads)找到對應 Linux 版本的安裝檔，然後下載並安裝。

### Import Virtual Machine

:::warning
此虛擬機大約需要 40 GB 的硬碟空間。
:::

開啟 VirtualBox 應用程式後，點選左方的 Tools 然後選擇 Import：


接著找到前面 ISE 解壓縮後目錄，然後選擇 `ova` 目錄下的 `14.7_VM.ova` 檔案：


最後按下 Import 並等待完成即可：


完成後左方應該會出現 ISE 的虛擬機：


:::warning
TODO: Network Adapter -> NAT?
:::