ターゲット FPGA ボードまたは SoC デバイスのプログラム

接続されたターゲット SoC デバイスまたは FPGA ボードを構成またはプログラムするには、HDL ワークフローアドバイザーの IP Core Generation ワークフローを使用します。

ターゲットデバイスをプログラムする方法

ワークフローアドバイザーの UI の使用

HDL ワークフローアドバイザーを開きます。ターゲット FPGA に実装するアルゴリズムを含む DUT サブシステムを右クリックし、[HDL コード] 、 [HDL ワークフローアドバイザー] を選択します。
[ターゲットデバイスおよび合成ツールを設定] タスクで、[ターゲットワークフロー] に IP Core Generation を指定し、[ターゲットプラットフォーム] として Generic Xilinx Platform または Generic Altera Platform 以外を指定します。
[ターゲットデバイスをプログラム] タスクを右クリックし、[選択したタスクまで実行] を選択します。
[ターゲットデバイスをプログラム] タスクで、[プログラミングメソッド] を指定し、このタスクを実行します。

HDL ワークフローアドバイザーの詳細については、HDL ワークフローアドバイザーのご利用の前にを参照してください。

ワークフローアドバイザースクリプトの使用

コマンドラインでターゲットデバイスをプログラムするには、[ターゲットデバイスおよび合成ツールを設定] タスクでターゲットワークフローとターゲットプラットフォームを指定した後、HDL ワークフローアドバイザー設定をスクリプトにエクスポートします。[HDL ワークフローアドバイザー] ウィンドウで、[ファイル] 、 [スクリプトへのエクスポート] を選択します。スクリプトは、hWC で表される hdlcoder.WorkflowConfig オブジェクトを作成し、構成します。

スクリプトを実行する前に、WorkflowConfig オブジェクトの ProgrammingMethod プロパティを使用することで、ターゲットハードウェアをプログラムする方法を指定できます。このコードの抜粋は、既定の Download [プログラミングメソッド] を使用するとき、HDL ワークフローアドバイザーからエクスポートしたスクリプト例を表示します。[ターゲットデバイスをプログラム] タスクを実行するには、WorkflowConfig オブジェクトの RunTaskProgramTargetDevice 属性を true に設定して、このスクリプトをカスタマイズします。

% This script was generated using the following parameter values:

% ...

% Set properties related to 'RunTaskProgramTargetDevice' Task
hWC.RunTaskProgramTargetDevice = true;
hWC.ProgrammingMethod = hdlcoder.ProgrammingMethod.Download;

% Validate the Workflow Configuration Object
hWC.validate;

%% Run the workflow
hdlcoder.runWorkflow('hdlcoder_led_blinking/led_counter', hWC);

[FPGA ビットストリームのビルド] タスクを実行した後、ワークフローアドバイザーは、以前のタスクをワークフローアドバイザーで再実行することなくターゲットデバイスをプログラムするワークフロースクリプトを生成するリンクを提供します。

リンクをクリックして、スクリプトを MATLAB^® エディターで開きます。このコードの抜粋は、HDL ワークフローアドバイザーによって生成されたスクリプト例を表示します。HDL ワークフローアドバイザーを閉じると、スクリプトを実行し、他のワークフロータスクを実行することなくターゲットハードウェアをプログラムできます。

% Load the Model

% ...

% Set Workflow tasks to run
hWC.RunTaskGenerateRTLCodeAndIPCore = false;
hWC.RunTaskCreateProject = false;
hWC.RunTaskGenerateSoftwareInterface = false;
hWC.RunTaskBuildFPGABitstream = false;
hWC.RunTaskProgramTargetDevice = true;

% Set properties related to 'RunTaskProgramTargetDevice' Task
hWC.ProgrammingMethod = hdlcoder.ProgrammingMethod.Download;

% Validate the Workflow Configuration Object
hWC.validate;

スクリプトベースのワークフローの詳細については、スクリプトを使用した HDL ワークフローの実行を参照してください。

プログラミングメソッド

ダウンロード

Zynq^® と Intel^® SoC ハードウェアプラットフォーム向けのリファレンス設計を使用している場合、コードジェネレーターは既定の [プログラミングメソッド] として Download を使用します。

[プログラミングメソッド] として Download を使用して [ターゲットデバイスをプログラム] タスクを実行すると、HDL Coder™ は、生成された FPGA ビットストリーム、Linux^® デバイスツリー、システム初期化スクリプトをターゲットボード上の SD カードにコピーし、SD カード上のビットストリームを持続的に保持します。このプログラミングメソッドの使用には、Embedded Coder^® ライセンスは必要ありません。[IP アドレス]、[SSH ユーザー名]、および [SSH パスワード] を指定して、SSH オブジェクトを作成できます。HDL Coder は、SSH オブジェクトを使用して、ビットストリームを SD カードにコピーし、ボードのプログラムを変更します。

Download メソッドを使用することを推奨します。このメソッドは FPGA ビットストリームをプログラムし、Linux システムを起動する前に、対応する Linux デバイスツリーを読み込むためです。そのため、Download メソッドの方が堅牢で、起動時のカーネルパニックやカーネルハングが起こりません。Linux の再起動中に、FPGA ビットストリームは SD カードから自動的に再プログラムされます。ワークフローアドバイザースクリプトを使用してワークフローを実行するときに Download を [プログラミングメソッド] として指定するには、WorkflowConfig オブジェクトの ProgrammingMethod プロパティ hWC が Download に設定されていることを確認してください。

hWC.ProgrammingMethod = hdlcoder.ProgrammingMethod.Download;

JTAG

JTAG を [プログラミングメソッド] として指定して [ターゲットデバイスをプログラム] タスクを実行するとき、HDL Coder は JTAG ケーブルを使用してターゲット SoC デバイスをプログラムします。このメソッドを使用して Intel、Xilinx^® SoC デバイスおよびスタンドアロン FPGA ボードをプログラムします。

SoC デバイスのプログラミングでは、Download メソッドを使用することを推奨します。JTAG モードでは ARM^® プロセッサは関係せず、オンボード FPGA が直接プログラムされます。このモードでは Linux デバイスツリーは更新されず、ビットストリームがデバイスツリーと一致しない場合には Linux システムのクラッシュやカーネルパニックに至ることがあります。この状況を回避するには、Download メソッドを使用して SoC デバイスをプログラムします。

スタンドアロン Intel および Xilinx FPGA ボードには組み込みの ARM プロセッサはありません。JTAG が FPGA ボードのプログラムに使用する既定のメソッドです。

ワークフローアドバイザースクリプトを使用してワークフローを実行するときに JTAG を [プログラミングメソッド] として指定するには、スクリプトを実行する前に、WorkflowConfig オブジェクトの ProgrammingMethod プロパティ hWC を JTAG に設定します。

hWC.ProgrammingMethod = hdlcoder.ProgrammingMethod.JTAG;

カスタム

ターゲットデバイスをプログラムする際、独自のカスタムリファレンス設計を作成するときにカスタムプログラミングメソッドを指定できます。hdlcoder.ReferenceDesign クラスの CallbackCustomProgrammingMethod を使用して、[ターゲットデバイスをプログラム] タスクを実行するときに実行されるコールバック関数の関数ハンドルを登録します。コールバック関数を定義するには、MATLAB 関数を定義するファイルを作成し、そのファイルを MATLAB パスに追加します。

この例のコードの抜粋では、カスタムプログラミングメソッドを使用するリファレンス設計定義ファイルを示します。詳細は、CallbackCustomProgrammingMethod を参照してください。

unction hRD = plugin_rd()
% Reference design definition

% ...

% Construct reference design object
hRD = hdlcoder.ReferenceDesign('SynthesisTool', 'Xilinx Vivado');

hRD.ReferenceDesignName = 'Parameter Callback Custom';
hRD.BoardName = 'ZedBoard';

% Tool information
hRD.SupportedToolVersion = {'2020.2'};

% ...

hRD.CallbackCustomProgrammingMethod = 
            @my_reference_design.callback_CustomProgrammingMethod;