Vivado 自作インターフェースを持つIPの作成方法

# はじめに

VivadoでZynqを使っているとBlockDiagramでIPコアを接続して回路を配置していくと思いますが、このIPコアをどうやって作るの？と質問を受けたため作り方を解説していきます。
また、複数の信号線を束ねる（インターフェースといいます）方法も説明します。

以前の[AXIインターフェースを持つIPの作成方法の記事](https://qiita.com/mmitti/items/4f1617eed4e527d850c2)も参考になると思います。

![bitmap.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/c602c7fa-5b9c-cd21-82ff-bf36e089fadd.png)
ブロック図の例([こちらの記事より](https://qiita.com/mmitti/items/3c7e85c845219ee392b0))
青い箱が**IPコア**、黒線が**信号線**、青線が**インターフェース**

## 環境
Vivado 2020.1 WebPACK Edition

## IPコアって？
IP(Intellectual Property-知的財産)コアは回路を機能単位でまとめたモジュールです。

VivadoではVerilogなどのHDL言語で記述したものを直接FPGAで動かす他にIPコアを複数接続してFPGAに乗せる方法があります(ブロックデザイン機能)。

IPコアはVivadoで用意されていて無償で使えるもののほか、有償で販売されているものあり、もちろん自作することも可能です。

## 取り扱う回路

ここでは以下の4本の信号線(まとめてCommandインターフェースとします）でデータをやり取りする回路を想定します。


| 方向 |  名前 | ビット幅 |         説明         |
|:----:|:-----:|:--------:|:--------------------:|
| M>S |  ADDR |     4    |       アドレス       |
| M>S |  DATA |     8    |        データ        |
| M>S | VALID |     1    | データ・アドレス有効 |
| M<S | READY |     1    |     要求受付可否     |

方向のMはマスター、Sはスレーブです。

また、ここでは送信を行うMaster回路とSlave回路を作成します。
(内部の処理はここでは考えないこととします。)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/af0dc3a8-d8c1-7738-22d7-e1e92f7e9d2e.png)
作成する回路と信号線の接続イメージです（なお、クロックとリセットは別で供給します。）

# インターフェースの作成
## インターフェースの定義ファイルの作成
まずはインターフェースの定義を作成します。

IPやインターフェースの作成を行うにはVivadoで適当なプロジェクトを開くか、IP管理用プロジェクトを作成するかします。

> IP管理用プロジェクトを作成する場合は Vivadoを起動後「Tasks」の「Manage IP」を選択し、「New IP Location」を選択します。
> ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/ad63dc2f-b803-ea65-193e-95ae2b6a5110.png)
> ダイアログが表示されるので「Next」を押し、
> ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/e6038429-caf2-14ad-ffbd-f33a60482545.png)
> 保存先やボードなどを設定して「Finish」を押します。
> ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/fa47a35e-df80-13b4-d3d7-b7b4a0816b46.png)

Vivadoのプロジェクトを開いた後は「Tools」から「Create Interface Definition...」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/77d0a2b3-a3b5-3bd6-6271-05863eb558d2.png)

インターフェースを作成するダイアログが表示されるのでインターフェース名や保存先などを入力します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/3b597911-046d-ecb9-5a87-07635e4c7f48.png)
> この例ではD:/IP/IFフォルダーの下にインターフェースの定義ファイル(XML)が作成されます。

## インターフェースの編集
インターフェースの定義ファイルを作成すると編集画面が表示されます。
まずは「Description」(説明)と「Display Name」(表示名-多分GUI上で使われる?)を入力します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/7b85f13c-2862-610b-32d8-c2e3d02e112c.png)

続けてインターフェースにポート(信号線)を追加するため「＋」ボタンを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/fe29e06e-4b04-e804-5626-fb374e6826e2.png)

ポートの定義を入力する画面が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/88680ee6-9fcf-33a9-e72b-84e0479d3d5a.png)

|      名前     |                       説明                       |
|:-------------:|:------------------------------------------------:|
|  Display Name |           表示名(IPブロックのポート名)           |
|  Description  |                   ポートの説明                   |
| Default Value |  デフォルト値(未接続時にinポートに設定される値)  |
|     Width     |                 ビット幅 -1で自動                |
|    Presence   |       必須(required) or オプション(option)       |
|   Direction   |                方向 図の場合SlaveからMasterとなる|
|      Type     | 種別(該当するものがあればチェック) |

> なお、制御線のデフォルト値は未接続時に回路がおかしくならないような値を選ぶ必要があります。
> 例えばVALIDを0にする、BUSYを1にするなど

例えばADDRの場合以下のようになります
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/46f35261-0980-f115-7a9c-691a51dee868.png)

入力後OKを押すとインターフェースの編集画面にポートが追加されます。

他の信号線も追加すると以下のようになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/29fbaf32-57aa-84fd-7238-423f892d2c08.png)

確認して問題がなければ「Save」を押してください。


### インターフェースを修正するには?
プロジェクトにIPのパスを設定した後(IP管理用プロジェクトの場合はIPのパスが予め設定されています。また、あるプロジェクトでIPやインターフェースを作成した場合もパスが設定されています。)、「IP Catalog」の「Interfaces」タブを開き、編集したいインターフェースを選択後、編集ボタン「![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/0f4d846f-3070-de44-d3b6-2d879d035b51.png)」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/0a22bcad-f3af-3dfd-efc5-551bb8b4499f.png)

インターフェース編集画面が表示されます。


# IPコアの作成
## IPの定義ファイル(と雛形コード)の作成
Vivadoのプロジェクトを開いた後「Tools」から「Create and Package New IP...」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/c7349a78-786e-6f1d-585b-4d0eebfaba3d.png)
ダイアログが表示されるので「Next」を押し、
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/436dfdbd-8d21-ad23-4c7b-4b5013d123e5.png)
今回は雛形を作るので「Create a new AXI4 peripheral」を選択し「Next」を押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/ec909103-d8b5-c5c1-c308-097bb3f66d06.png)
IPの名前や保存場所などを入力して「Next」を押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/91617975-194e-2ce6-9903-26fc1771608a.png)

今回は自作インターフェースのみの回路を作るためデフォルトのままにして「Next」を押します。
自作インターフェースとAXIを持つIPを作る場合はここでAXIの設定もします。
※AXIなしでは作成できません。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/aa61a3a3-3882-9765-a091-e643a3246549.png)
最後に次に何をするのか聞かれるので「Edit IP」を選択して「Finish」を押します。（IPの定義ファイル(XML)と雛形のVerilogファイル、IP編集用プロジェクトが生成されて開きます。）
※ここで編集しなくても後から編集することもできます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/d62d322d-c3ba-2ce6-d992-fe3d6ab50b43.png)

## 回路の作成・ファイルの追加削除
まずはIPの中身である回路を記述します。
AXIの雛形でIPを作成すると上位回想のモジュールとAXI本体のモジュールの2つが生成されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/effa0126-75ff-9fd8-68bc-2442af3a767e.png)
この内下位モジュールは不要なのでファイルごと削除し、上位モジュールの中の記述を書き換えます。
なお、IP編集用プロジェクトの方でファイルを追加、削除してもIP本体に反映されないため手動で反映させる必要があります。

「Package IP」内の「File　Groups」を開き、「Merge changes from File Groups Wizard」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/ecf14bf0-5702-3742-1645-5ed05316e082.png)

※IP編集用プロジェクトはあくまで一時的なものなので、Package IPでIPの定義ファイルに反映させる必要があります。

上位モジュールは今回は適当に実装します。

```verilog
`timescale 1 ns / 1 ps
module Master_v1_0 #(
    parameter CONST_ADDR = 4'd0,
    parameter CONST_DATA = 8'd0
) (
    input clk,
    input rst,
    output [3:0] addr,
    output [7:0] data,
    output valid,
    input ready
);
    assign addr = CONST_ADDR;
    assign data = CONST_DATA;
    assign valid = 1;
endmodule

```

ファイルを追加する場合は「Sources」の「Design Sources」を右クリックして「Add Sources...」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/9367cee1-b988-e424-6faf-cf664532ee81.png)

一般的にHDL記述の保存場所はIPの保存先のhdlフォルダーの中に配置します。

ファイル追加後は削除時同様に「Merge changes from File Groups Wizard」を選択して同期してください。

なお、**ファイルを追加したり作成する場合**はIPの定義ファイル(xml)がある**フォルダー以下に配置**することが推奨されます。

### 手動でHDL記述を追加する場合
Vivadoのバグなどでうまく同期ができない場合は手動で追加します。
「Package IP」の「File Groups」の「Verilog(VHDL) Synthesis」と「Verilog(VHDL) Simulation」をそれぞれ右クリックして「Add File」を選択して追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/ce30a175-e5a3-b657-f205-e438cb7d4794.png)

この手順で追加した場合はIP編集用プロジェクトに反映されないため一旦プロジェクトを閉じて後述する方法で編集用プロジェクトを再生成する必要があります。

## IPコアの設定
ファイルを追加したらIPの設定をしていきます。
### IPコアの情報(Identification)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/98ce66a0-fe2e-aaab-a6bb-b66391a785b9.png)

バージョン番号や作成者、IPコアの名前や説明などを入力します。
「Categories」はIPコアのカテゴリーを選択します。ここで選択したものが「IP Catalog」に反映されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/60d25b00-1b24-3b3d-2bb6-7b57e31c9a4a.png)
AXIの雛形で作成するとデフォルトはAXI Peripheralが指定されているためIPカタログ上は図のようになります。

### パラメーター(Customization Parameters)
IPコアにGUIで変更可能なパラメーター(Customization Parameters)と隠しパラメーター(Hidden Parameters)を含めることができます。
デフォルトではAXIの雛形のパラメーターが入っています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/4686925d-1435-8290-ddcb-623eee66e7c9.png)

Verilogの上位モジュールからこれらのパラメーターを削除した場合はエラーになるかもしれないので一旦削除します。

サンプルのVerilogのように上位モジュールにパラメーターを含む場合は、適当なところを右クリックして「Import IP Parameters...」を選択し

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/de56d37f-d10d-835d-b525-beee8c524698.png)

最上位のVerilog/VHDLファイルとモジュール名を選択してOKを押すとインポートできます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/34aa95fc-e221-caba-2bb0-926b6ba5fd23.png)

インポート後、デフォルト値や型が期待通りか確認します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/f4883a01-2702-5d3c-cd72-85cd3a69f9fb.png)
図の例では型とデフォルト値がおかしいので項目をダブルクリックして編集します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/60813ecd-b3d3-d2f9-aea3-fcf2cd31d98f.png)
型やデフォルト値、値の範囲などを入力できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/dd567697-623b-1ac0-0947-145bf10321d2.png)
今回はCONST_ADDRは0~15のlong型、CONST_DATAは0,32,64のlong型にしてみました。


### ポート(Ports and Interfaces)
IPコアの入出力を指定します。
こちらもAXIの雛形が指定されているためすべてのインターフェースを削除し、再インポートします。
>上位モジュール編集時にMerge changes from~が表示され、こちらを押すと自動的に同期される場合がありますが、うまく行かない場合はインターフェースを削除してから再インポートし直すと良いと思います。
> ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/409519fd-613b-b5f8-5538-2b1d59ae4153.png)



![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/18f6e554-d474-66a0-3089-3c53924c9305.png)

まず表示されているすべてのインターフェースを削除し、ポートだけの状態にします。

インターフェースを削除するには削除したいインターフェース![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/e79bea8a-dcf2-0bf3-575d-365e8d2255a1.png)を右クリックし「Remvoe Interface」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/2f9ec1c6-0e62-1061-f3aa-21950c967e46.png)

「Clock and Reset Signals」などのフォルダー内にもインターフェースがあるため全て削除します。

すべてのインターフェースを削除すると図のようになります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/5df92581-6900-afd1-1947-8dd30b2d91b8.png)


次に適当なところを右クリックして「Import IP Ports...」を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/295f4866-02d0-afd7-e6e4-e6d22e42891d.png)

上位モジュールのVerilog/VHDLファイルとモジュール名を選択してOKを押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/871c72db-87a3-46b3-d4d6-ce53d51f9d22.png)

図のようにサンプルのVerilogの入出力と同じものが表示されると思います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/9c33f7b1-a24d-529d-91cd-15118b6fb088.png)


続けてて、クロック、リセット、インターフェースの割当を行います。
クロックやリセットのポートを右クリックし、「Auto Infer Signle Bit Interface」を選択し、「Clock」や「Reset」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/e4a780e0-0757-130c-cbe6-51fa43b924e0.png)

インターフェースはインターフェースを構成するポートを複数選択し、「Auto Infer Interface...」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/aa5e4d40-c2f0-936b-b483-d308c402528f.png)

インターフェースを選択するダイアログが表示されるので、先ほど作成したインターフェースを選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/5c0126d5-5828-b48f-236a-228b50f6bcf0.png)

インターフェースの編集ダイアログが表示されます。

Generalタブにはインターフェースの名前やMaster/Slave設定、説明などが変更できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/bdc25c72-fd7e-debb-18e0-89b6da95bee1.png)

Port MappingはIPのポートとインターフェースのポートの対応付けを行います。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/902e2257-9b85-87bd-694a-ae6f914e4270.png)

Master/SlaveとPort Mappingはポート名が同じであれば自動的に推定されてマッピングされます。

マッピングがおかしい場合はMapped Ports Summaryから削除したいものを選択し「![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/3fc6cff8-97c0-7536-5c4a-18b50823747d.png)」を押して削除した後に
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/c8f5b0dc-ec45-4e80-b6ec-f842cff5757c.png)

「Interface's Logical Ports」と「IP's Physical Ports」からそれぞれポートを選択後「Map Ports」を選択して対応付けます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/db1a3dea-6f8e-39da-b4e6-0d03dfb4eed6.png)

> Vivadoのバグか![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/e5b0f200-f079-d77c-3245-d354ad45f239.png)を押して削除できない場合がありますが、適当にMap Portsを押すと押せるようになりました。

対応付を確認後OKを押してインターフェースを登録します。

最後にインターフェースとクロックを対応付けるため、作成したインターフェースを右クリックして「Associate Clocks...」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/c18a38e9-be0a-4d15-f9f3-d9546ac70779.png)

最初に登録したClockが表示されると思うので、それにチェックを入れてOKを押して閉じます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/6e4388bd-d950-bb94-bb58-80117c271c2e.png)


### メモリ空間(Addressing and Memory)
AXIがアクセスするメモリの範囲などを設定します。AXIの雛形を使用してIPを作成後、AXIのインターフェースを削除した場合は不要なので削除します。

MemoryMap名を右クリックして「Remove Memory Map」を選択することで削除できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/8cea0df7-d0aa-2b6d-c892-016f10bfb9c0.png)

### GUIの設定(Customization GUI)
BlockDiagramでIPコアを追加するときに表示されるダイアログをカスタマイズできます。先程パラメーターを追加したものが編集できることが確認できると思います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/58bf022e-f80a-c797-fadd-bd2c34f1c55f.png)

特に問題なければそのままにしておきます。


### IPのパッケージ(Review and Package)
最後にIPコアのエラーや保存場所などを確認し、問題なければ「Re-Package IP」を選択してIPコアの設定を保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/c294a67c-b670-fd09-2f42-30a896a82ed4.png)

### Slaveの作成
SlaveもMaster同様に作成します。以下に最上位モジュールのVerilogコードを示します。

```verilog
`timescale 1 ns / 1 ps
module Slave_v1_0 (
    input clk,
    input rst,
    input [3:0] addr,
    input [7:0] data,
    input valid,
    output ready
);
    assign ready = 1;
endmodule

```


## IPコアを再編集するには？

IP Catalogから作成したIPを探し、右クリックして「Edit in IP Packeger」を選択することで編集用一時プロジェクトを生成して編集できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/a4702940-a458-2192-9175-578ad54f2e91.png)


# IPコアを利用する

最後に作成したIPを利用して見ます。
とりあえずVivadoでRTLプロジェクトを作成します。
> Verilogファイルはついかしないので途中のProject Typeは Do not specify sources at this timeにチェックを入れるとダイアログの量が減ります。
> ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/28e18642-4720-d4ca-636a-b670699b3891.png)

## プロジェクト設定
作成したIPのパスをプロジェクトに設定します。

「Flow Navigator」の「Settings」を選択して設定画面を開きます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/2bf203ca-35a8-8e4f-472e-99f850d5a9e2.png)
「ProjectSettings」の中から「IP」を開き、「Repository」を選択します。
IP RepositoriesにIP（やインターフェース）のパスを設定しますので、追加ボタン「![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/ba8f9a03-e0ee-b90e-3d5d-ea332778b51b.png)」を選択して、IPの保存場所を指定します（再帰的に探してくれるので保存先のルートフォルダーを指定すれば良いです）。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/7afbb164-31d8-b6d6-ca14-ab0b0f92c219.png)
IPやインターフェースが見つかれば一覧が表示されます。
Master/SlaveとCommandが含まれていることを確認し、設定画面も閉じてください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/e27abfe4-0220-5ffd-27ee-53690a4c4fe4.png)

これでIPとインターフェースがIP Catalogに登録されます。

## ブロックデザイン

最後にブロックデザインを作成します。
「Flow Navigator」の「Create Block Design」を選択し、
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/8d42831d-bfd3-a5d1-06a0-a230db979693.png)
名前などを適当に入力して作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/9164c92d-0187-c5ca-6fa2-9dcfac3d9037.png)

続けて空のブロックデザインに作成したIPを追加します。
適当なところを右クリックして「Add IP...」を選択すると
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/ec7d3ddf-0141-10dd-2062-16d9b1dd7403.png)

IP検索ボックスが表示されるのでMasterを探し、ダブルクリックして追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/88445f84-cb26-b9ab-ca52-e5a6085244bf.png)

ブロックデザインにMasterが追加されました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/66689c63-93df-5cf4-6a26-0ec43b5a52c0.png)

ここで追加されたMasterをダブルクリックするとパラメーター編集画面が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/8ba8b9c6-e7e3-81ed-fc79-dc8c136a767d.png)

IP作成時に指定した Const AddrパラメーターとConst Dataパラメーターが変更できることが確認できます。

同様にSlaveを探して追加します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/cff56dbb-e872-3aaa-17ef-c060a36e6eee.png)

ここでMasterのCommandの横の「![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/bf88eb2c-3f23-d7cb-2e7e-05d265b895ce.png)」にカーソルを載せクリックしながらSlaveの「![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/bf88eb2c-3f23-d7cb-2e7e-05d265b895ce.png)」までカーソルを持っていき離すとインターフェースの接続ができます。
![Diagram-2020-07-26-00-28-59.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/c11264e2-a2b1-7cce-cb77-0b872d33dce7.gif)

これで自作インターフェース付きIPがブロックデザインで利用できることが確認できました。

# TIPS
## IPにアイコンを入れたい

JPEG, GIF, PNGのアイコンに対応しています。
（サイズに関してはドキュメントに記載が無いのです（見つけられてないだけかも）が、自動的にリサイズされますので、試行錯誤して丁度いいサイズを見つける必要があります。）

例えば以下のようなicon.png(32px*32px)を用意したとして、IPにアイコンを組み込んでみます。

![icon.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/738c352a-2587-adef-6983-1edf5c8e57e6.png)

まず、IPの編集用プロジェクトを開き、「Package IP」から「File Groups」を開き、適当なところを右クリックして「Add File Group...」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/0b793f12-6722-c6f1-ea1c-5f06a078337b.png)

ダイアログが表示されるので「Advanced」の中から「Utility XIT/TTCL」を選び「OK」を押します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/748acfdf-37e6-619f-9c16-1c80cc769915.png)

File GroupsにUtility XIT/TTCLが追加されました。

続けてアイコンファイルを登録します。

「File Groups」の「Advanced」の中の「Utility XIT/TTCL」を右クリックし「Add Files...」を選択します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/dd32d63b-ab0f-944a-bd80-b8c18fbccadb.png)

ファイルを追加するダイアログが表示されるので「Add Files」を押してアイコンファイルを選択し、OKを押して閉じます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/b502f376-0e74-a4f5-d550-0f1167e9f791.png)

次にRe-Package IPを押して保存して閉じます。

このままではIconが表示されないためIP定義ファイル(component.xml)を手動で編集します。

追加したアイコンファイルに関する部分を探し、userFileType imageの下にLOGOを追加します。

```xml
    <spirit:fileSet>
      <spirit:name>xilinx_utilityxitfiles_view_fileset</spirit:name>
      <spirit:file>
        <spirit:name>icon.png</spirit:name>
        <spirit:userFileType>image</spirit:userFileType>
        <spirit:userFileType>LOGO</spirit:userFileType> <!-- NEW -->
      </spirit:file>
    </spirit:fileSet>
  </spirit:fileSets>
```

xmlを保存して閉じます。

この後ブロックデザインに戻り、アイコンを追加したIPを追加すると以下のようにアイコンが表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/140084/cdf61316-bb2f-32ef-2c0c-2f5f34edb88a.png)


# 資料

[UG994 Vivado Design Suite ユーザー ガイド: IP インテグレーターを使用した IP サブシステムの設計](https://japan.xilinx.com/support/documentation/sw_manuals_j/xilinx2020_1/ug994-vivado-ip-subsystems.pdf)

[UG1118 Vivado Design Suite ユーザー ガイド: カスタム IP の作成とパッケージ](https://japan.xilinx.com/support/documentation/sw_manuals_j/xilinx2019_2/ug1118-vivado-creating-packaging-custom-ip.pdf)