hdl.BlackBox

カスタム HDL コードを含めるためのブラック ボックス

説明

hdl.BlackBox を使用すると、古い形式のコードや手書きの HDL コードなどのカスタム HDL コードを、HDL コード生成用の MATLAB^® 設計に含めることができます。

hdl.BlackBox から継承するユーザー定義の System object™ を作成するときに、カスタム HDL コードに合った端子インターフェイスとシミュレーション動作を指定します。

System object に定義した動作に基づいて、HDL Coder™ により MATLAB 内の設計がシミュレートされます。HDL コードの生成時には、シミュレーションの動作のコードが生成されるのではなく、System object に指定した端子インターフェイスをもつモジュールがインスタンス化されます。

生成された HDL コードを大規模システムで使用するには、カスタムの HDL ソース ファイルを、生成された残りのコードと共に設計に含めます。

カスタム HDL コードを含めるには次のようにします。

1. hdl.BlackBox オブジェクトを作成して、そのプロパティを設定します。

2. 関数と同様に、引数を指定してオブジェクトを呼び出します。

System object の機能の詳細については、System object とはを参照してください。

作成

構文

hdl.BlackBox

説明

HDL コード生成用のブラック ボックスを作成するには、hdl.BlackBox から継承する System object を作成します。MATLAB 設計へのカスタム HDL コードの統合を参照してください。

プロパティ

特に指定がない限り、プロパティは "調整不可能" です。つまり、オブジェクトを呼び出した後にプロパティ値を変更することはできません。オブジェクトは呼び出し時にロックされ、関数 release でロック解除されます。

プロパティが "調整可能" な場合は、いつでも値を変更できます。

プロパティ値の変更の詳細については、System object を使用した MATLAB でのシステム設計を参照してください。

メモ

[AddClockEnablePort]、[AddClockPort]、および [AddResetPort] プロパティを使用して、Simulink^® モデルでクロック信号、リセット信号、およびクロック イネーブル信号を明示的に指定することはできません。代わりに、以下のプロパティを使用して、生成された HDL コードにクロック端子、リセット端子、またはクロック イネーブル端子を追加します。

AddClockEnablePort — クロック イネーブル端子を追加

'on' (既定値) | 'off'

'on' の場合、ブラック ボックス System object 用に生成されるインターフェイスにクロック イネーブル入力端子が追加されます。端子の名前は ClockEnableInputPort で指定します。

AddClockPort — クロック端子を追加

'on' (既定値) | 'off'

'on' の場合、ブラック ボックス System object 用に生成されるインターフェイスにクロック入力端子が追加されます。端子の名前は ClockInputPort で指定します。

AddResetPort — リセット端子を追加

'on' (既定値) | 'off'

'on' の場合、ブラック ボックス System object 用に生成されるインターフェイスにリセット入力端子が追加されます。端子の名前は ResetInputPort で指定します。

AllowPipelineDistribution — 分散型パイプライン方式および遅延吸収のレジスタの配置

'off' (既定値) | 'on'

'on' の場合、ブラック ボックス System object 全体で HDL Coder による入力から出力または出力から入力へのレジスタの移動が可能になります。

ClockEnableInputPort — クロック イネーブル入力端子の名前

'clk_enable' (既定値) | 文字ベクトル

クロック イネーブル入力端子の HDL 名。文字ベクトルとして指定します。

ClockInputPort — クロック入力端子の名前

'clk' (既定値) | 文字ベクトル

クロック入力端子の HDL 名。文字ベクトルとして指定します。

EntityName — モジュールまたはエンティティの名前

System object インスタンスの名前 (既定値) | 文字ベクトル

ブラック ボックス System object 用に生成される VHDL^® エンティティ、Verilog^® モジュール、または SystemVerilog モジュールの名前。文字ベクトルとして指定します。

例: 'myBlackBoxName'

ImplementationLatency — クロック サイクル単位のレイテンシ

-1 (既定値) | 整数

ブラック ボックス System object のクロック サイクル単位のレイテンシ。整数として指定します。

0 より大きい場合、この値が遅延の均衡化に使用されます。

-1 の場合、レイテンシは不明です。これにより遅延の均衡化は無効になります。

InlineConfigurations — VHDL 構成を生成

InlineConfigurations グローバル プロパティの値 (既定値) | 'on' | 'off'

'on' の場合、VHDL 構成が生成されます。

'off' の場合、VHDL 構成が生成されず、ユーザーによる外部構成が必要になります。独自の VHDL 構成を作成する場合は 'off' に設定します。

InputPipeline — 入力パイプライン ステージ

0 (既定値) | 正の整数

生成されたコードに挿入する入力パイプライン ステージ数 (パイプラインの深さ)。

OutputPipeline — 出力パイプライン ステージ

0 (既定値) | 正の整数

生成されたコードに挿入する出力パイプライン ステージ数 (出力パイプラインの深さ)。

ResetInputPort — リセット端子の名前

'reset' (既定値) | 文字ベクトル

リセット入力端子の HDL 名。文字ベクトルとして指定します。

VHDLArchitectureName — VHDL アーキテクチャの名前

'rtl' (既定値) | 文字ベクトル

VHDL アーキテクチャの名前。文字ベクトルとして指定します。アーキテクチャの名前は、InlineConfigurations が 'on' の場合にのみ生成されます。

VHDLComponentLibrary — VHDL コンポーネント ライブラリの名前

'work' (既定値) | 文字ベクトル

VHDL コンポーネントを読み込むライブラリ。文字ベクトルとして指定します。

NumInputs — カスタム入力端子の数

1 (既定値) | 正の整数

カスタム HDL コード内の追加の入力端子の数。正の整数として指定します。

NumOutputs — カスタム出力端子の数

1 (既定値) | 正の整数

カスタム HDL コード内の追加の出力端子の数。正の整数として指定します。

オブジェクト関数

オブジェクト関数を使用するには、System object を最初の入力引数として指定します。たとえば、obj という名前の System object のシステム リソースを解放するには、以下の構文を使用します。

release(obj)

全 System object 共通

step	System object のアルゴリズムの実行
release	リソースを解放し、System object のプロパティ値と入力特性の変更を可能にします。
reset	System object の内部状態のリセット

拡張機能

HDL コード生成
HDL Coder™ を使用して FPGA 設計および ASIC 設計のための VHDL、Verilog および SystemVerilog のコードを生成します。

バージョン履歴

R2015a で導入

参考

coder.HdlConfig

トピック

• MATLAB 設計へのカスタム HDL コードの統合
• MATLAB アルゴリズムからのボードに依存しない IP コアの生成
• サブシステムのブラック ボックス インターフェイスの生成