カスタムボードの登録

カスタムボードを登録するには、次を行わなければなりません。

ボードを定義します。
ボードプラグインを作成します。
ボード登録関数を定義するか、新しいボードプラグインを既存のボード登録関数に追加します。

ボードの定義

開始する前に、ボードの詳細を参照できるようにボードのドキュメンテーションを手元に用意します。

要件

ボード定義は次の要件を満たさなければなりません。

hdlcoder.Board オブジェクトを返す MATLAB^® 関数である。
ボード定義関数には任意の名前を指定できます。
自身のボードプラグインフォルダー内にある。

ボードの定義方法

MATLAB 関数を定義する新しいファイルを任意の名前で作成します。
MATLAB 関数で hdlcoder.Board オブジェクトを作成し、そのプロパティとインターフェイスをカスタムボードの特性に基づいて指定します。
必要に応じて validateBoard メソッドを実行し、定義が完全であることを確認します。

たとえば、次のコードはボードを定義します。

function hB = plugin_board()
% Board definition

% Construct board object
hB = hdlcoder.Board;

hB.BoardName    = 'Digilent Zynq ZyBo';

% FPGA device information
hB.FPGAVendor   = 'Xilinx';
hB.FPGAFamily   = 'Zynq';
hB.FPGADevice   = 'xc7z010';
hB.FPGAPackage  = 'clg400';
hB.FPGASpeed    = '-2';

% Tool information
hB.SupportedTool = {'Xilinx Vivado'};

% FPGA JTAG chain position
hB.JTAGChainPosition = 2;

%% Add interfaces
% Standard "External Port" interface
hB.addExternalPortInterface( ...
    'IOPadConstraint', {'IOSTANDARD = LVCMOS33'});

ボードプラグインの作成

要件

ボードプラグインには次が適用されます。

ボード定義ファイルが含まれるパッケージフォルダーでなければならない。
パッケージフォルダーは、フォルダー名の前に + という接頭辞が付いています。たとえば、ボードプラグインは +ZedBoard という名前のフォルダーにすることができます。
MATLAB パス上になければならない。
1 つ以上のリファレンスプラグインを含めることができる。

ボードプラグインの作成方法

+ 接頭辞を使用した名前のフォルダーを作成します。
ボード定義ファイルをそのフォルダーに保存します。
そのフォルダーを MATLAB パスに追加します。

ボード登録関数の定義

要件

ボード登録関数には次が適用されます。

hdlcoder_board_customization.m という名前を付けなければならない。
文字ベクトルの cell 配列として指定されるボードプラグインのリストを返す。
MATLAB パス上になければならない。

ボード登録関数の定義方法

hdlcoder_board_customization.m という名前でファイルを作成し、MATLAB パス上の任意の場所に保存します。
hdlcoder_board_customization.m で、文字ベクトルの cell 配列としてボードプラグインのリストを返す関数を定義します。
たとえば、次のコードはボード登録関数を定義します。
```
function r = hdlcoder_board_customization
% Board plugin registration files
% Format: % board_folder.board_definition_function

r = {'ZyboRegistration.plugin_board'};

end
```