エントリポイント関数の入力のプロパティの指定

入力プロパティを指定する場合

MATLAB^® アルゴリズムのテスト ベンチを提供する場合は、基本関数の入力を手動で指定する必要はありません。HDL Coder™ ソフトウェアは、テスト ベンチを使用してデータ型を推定します。

入力プロパティを指定しなければならない理由

HDL Coder は MATLAB ファイル内のすべての変数のプロパティをコンパイル時に判別しなければなりません。MATLAB ファイル内の変数のプロパティを推定するために、HDL Coder は、"基本" 関数 ("最上位" 関数または "エントリポイント" 関数としても知られる) への入力のプロパティを特定できなければなりません。そのため、基本関数に入力がある場合は、これらの入力のプロパティを HDL Coder に指定しなければなりません。基本関数が入力パラメーターをもたない場合は、HDL Coder では MATLAB ファイルを修正せずにコンパイルできます。基本関数から呼び出されるローカル関数または外部関数に対する入力のプロパティは指定する必要はありません。

メモ

基本関数をパッケージ内に含めることはできません。パッケージ外でラッパー関数を基本関数として作成します。新しい関数内で目的の関数を基本関数として呼び出します。

HDL Coder プロジェクトでチルダ (~) 文字を使用して未使用の関数入力を指定し、生成されるコードで異なる型を表示させる場合は、その型を指定します。それ以外の場合は、入力は既定で実数のスカラーの double になります。

基本入力のプロパティの定義方法

方法	利点	欠点
Define Input Properties by Example at the Command Line メモ MATLAB ファイルでプログラムによって入力プロパティを定義する場合は、この方法は使用できません。	使いやすい。 元の MATLAB コードを変更しない。 少数の基本入力をもつ関数のプロトタイプを作成するために設計されている。	起動するたびにコマンド ラインで指定しなければならない (スクリプトを使用しない場合)。 大きな構造体や配列など、メモリを大量に使用する入力を指定する場合は効率的でない。
MATLAB ファイル内でのプログラムによる入力プロパティの定義	MATLAB コードと統合されているため、HDL Coder を呼び出すたびにプロパティを再定義する必要がない。 MATLAB コード内にプロパティ仕様のドキュメンテーションが提供されている。 大きな構造体などメモリを大量に使用する入力を指定する場合に効率的である。	複雑な構文を使用する。 HDL Coder プロジェクト ファイルは、現在、プログラムで定義されたプロパティを認識しない。プロジェクトを使用する場合は、入力の型をプロジェクトに再入力しなければならない。

指定するプロパティ

基本関数が入力をもつ場合は、入力ごとに次のプロパティを指定しなければなりません。

対象	指定するプロパティ
	クラス	サイズ	実数/複素数	numerictype	fimath
固定小数点入力
その他の入力

以下のデータ型は、基本関数内で使用できますが、基本関数の入力としてはサポートされていません。

• 構造体

• 行列

可変サイズ データは、テスト ベンチと基本関数ではサポートされていません。

既定のプロパティ値

HDL Coder では基本関数入力のプロパティに対して次の既定値が割り当てられます。

プロパティ	既定値
クラス	double
サイズ	scalar
実数/複素数	real
numerictype	既定値なし
fimath	hdlfimath

サポートされているクラス

以下の表に HDL Coder でサポートされているクラス名を示します。

クラス名	説明
logical	真および偽の値の logical 配列
char	文字配列
int8	8 ビット符号付き整数配列
uint8	8 ビット符号なしの整数配列
int16	16 ビット符号付き整数配列
uint16	16 ビット符号なしの整数配列
int32	32 ビット符号付き整数配列
uint32	32 ビット符号なしの整数配列
single	単精度浮動小数点または固定小数点の数値配列
double	倍精度浮動小数点または固定小数点の数値配列
embedded.fi	固定小数点の数値配列

基本入力のプロパティの指定規則

基本入力のプロパティを指定するときは次の規則に従います。

• すべての基本入力のクラスを指定しなければなりません。基本入力のサイズまたは実数/複素数を指定しない場合は、既定で実数のスカラーになります。

• クラスが固定小数点 (fi) である基本関数入力ごとに、入力の numerictype と fimath プロパティを指定しなければなりません。