このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。
FPGA Data Capture
ライブFPGAからMATLABワークスペースに対話的にデータをキャプチャします
説明
FPGA データ キャプチャ ツールは、FPGA 上で実行されているデザインからデータをキャプチャし、 MATLAB®ワークスペースに返します。戻り値のデータ型を構成し、キャプチャ ウィンドウの数とトリガー ステージの数を指定し、データをキャプチャするタイミングを制御するトリガー条件を設定し、キャプチャするデータを制御するキャプチャ条件を設定できます。
このツールを使用する前に、FPGA データ キャプチャ コンポーネント ジェネレーター ツールを使用して、カスタマイズされたデータ キャプチャ コンポーネントを生成しておく必要があります。また、生成された IP コードをプロジェクトに統合し、FPGA にデプロイする必要があります。このツールは、JTAG またはイーサネット ケーブルを介して FPGA と通信します。必要なケーブルがボードとホスト コンピュータの間に接続されていることを確認してください。
このツールは、生成されたhdlverifier.FPGADataReader
System object™のラッパーです。FPGA データ キャプチャ ツールは、ワークスペースで変数fpgadc_obj
を定義します。この変数がすでに存在する場合、ツールは既存のオブジェクトを使用して開き、そのオブジェクトへの変更を保存します。
ワークフローの概要については、 「データキャプチャのワークフロー」を参照してください。
FPGA Data Capture を開く
MATLAB コマンド プロンプト: 「
launchDataCaptureApp
」と入力します。この関数は、他の生成されたデータ キャプチャ コンポーネントと同じフォルダーに生成されたスクリプトです。
例
パラメーター
Capture Data
— データをキャプチャするタイミング
Immediately
(既定値) | On trigger
デフォルト設定のキャプチャImmediately
、トリガー条件は無視され、 Capture Dataをクリックするとデータのバッファがキャプチャされます。FPGA ロジックの特定のイベントを含むデータをキャプチャするには、トリガー条件を構成し、 On trigger
を選択します。この場合、データ キャプチャ ロジックはトリガー条件が true になるまで待機し、その後データのバッファをキャプチャします。
Capture Dataをクリックすると、 Stopボタンのあるウィンドウが開きます。キャプチャの試行をキャンセルしたい場合 (トリガー条件が発生しない場合など)、 Stopをクリックして制御をツールに戻します。キャプチャの試行を中止すると、 MATLABにはデータが返されません。
Output variable name
— キャプチャされたデータを返す構造体の名前
dataCaptureOut
(既定値) | 文字ベクトル
キャプチャされたデータは、ベースMATLABワークスペースの構造体変数に返されます。各信号から返されるデータは、Sample depth
値のベクトルです。各信号は構造体のフィールドになります。構造体のフィールド名はSignal Nameと同じです。
Display data with Logic Analyzer
— ロジック アナライザーでデータを自動的に表示する
on
(既定値) | off
このオプションは、 DSP System Toolbox™ライセンスをお持ちの場合に表示されます。このオプションを選択すると、データ キャプチャの完了後、ツールは [ロジック アナライザ] ウィンドウを開き、キャプチャされたデータを表示します。時間軸はサンプル単位で測定されます。カーソルの位置は、トリガーが検出された時間を示します。
Sample depth
— 各信号でキャプチャされたサンプルの数
2の整数乗
このパラメーターは読み取り専用です。生成時に指定した値が反映されます。
Number of capture windows
— データキャプチャの繰り返し回数
1
(既定値) | 2の整数乗
キャプチャする繰り返しの数を指定します。この値は 2 のべき乗である必要があり、 Sample depthを超えることはできません。サンプルの深さを指定するときは、データを読み取るときに構成する予定のウィンドウの数を考慮してください。これは、これらのウィンドウが各キャプチャ ウィンドウのウィンドウの深さに影響を与えるためです。ウィンドウの深さは、 Sample depthをNumber of capture windowsで割ったものです。FPGA データ キャプチャ コンポーネント ジェネレーター ツールでSample depthを指定します。
以下に例を示します。Sample depthが4096
で、 Number of capture windowsが4
の場合、各キャプチャ ウィンドウのウィンドウ深度は1024
。
Number of trigger stages
— トリガ条件を与えるトリガ段数
M (既定値) | 1 からMの整数
Trigger position
— キャプチャバッファ内のトリガ検出サイクルの位置
0
(既定値) | window depthまでの整数 —1
デフォルトでは、トリガが検出されたときのクロック サイクルはキャプチャ バッファの最初のサンプルです。キャプチャ バッファ内でのトリガ検出サイクルの相対位置を変更できます。デフォルト以外のトリガー位置は、トリガーが発生する前に一部のサンプルがキャプチャされることを意味します。このパラメーターは、 0 からwindow depth—1 までの任意の数値に設定できます。トリガ位置がwindow depth-1 に等しい場合、最後のサンプルはトリガが発生したときのサイクルに対応します。Number of capture windowsが 1 より大きい場合、同じトリガー位置がすべてのウィンドウに適用されます。詳細については、トリガーを参照してください。
Signal
— トリガーコンポーネント信号名
文字ベクトル
このパラメーターは読み取り専用です。生成時に指定した信号名が、下部のドロップダウン メニューにリストされます。+ボタンをクリックして、トリガー条件に信号を追加します。
Operator
— トリガー条件内の信号を比較する演算子
==
| !=
| <
| >
| <=
| >=
信号を比較するには、次の演算子のいずれかを選択します: ==
、 !=
、 <
、 >
、 <=
、または>=
。X
またはx
(ドントケア値) を含む信号を比較するには、 ==
または!=
を指定します。 $演算子。
Value
— 全体的なトリガー条件の一部として信号を比較する値
小数 | バイナリ | 16進数 | Low
| High
| Falling edge
| Rising edge
| Both edges
トリガー条件は、1 つ以上の信号の値比較で構成できます。このパラメーターは、各信号に一致する値を指定します。
マルチビット信号の場合は、信号に関連付けられたデータ型の範囲内の 10 進数、2 進数、または 16 進数の値を指定します。16 進値または 2 進値を指定するときに、 X
またはx
(ドントケア値) を組み合わせて値を指定して、ビット マスキングを有効にすることができます。値を比較する際、トリガー条件はX
またはx
の位の値を破棄し、出力を提供します。
読みやすくするためにビットのグループを分離するには、ビット間に_
を使用できます。たとえば、32 ビットのバイナリ値を0b1010_XXXX_1011_XXXX_1110_XXXX_1111XXXX
として表し、32 ビットの 16 進値を0xAB_CDEXFX
として表すことができます。
boolean
信号の場合、レベルまたはエッジ条件を選択します。詳細については、トリガーを参照してください。
Trigger combination operator
— トリガ条件を作成するための論理演算子
AND
(既定値) | OR
このパラメーターは、ロジック ゲートのアイコンで示されます。[Change operator]ボタンをクリックして、 AND
とOR
を切り替えます。
トリガー条件は、1 つ以上の信号の値比較で構成できます。これらの値の比較を 1 種類の論理演算子のみと組み合わせます。3 つの信号A
、 B
、およびC
がトリガー条件を構成しているとします。次のオプションがあります。
A == 10 AND B == 'Falling edge' AND C == 0
A == 10 OR B == 'Falling edge' OR C == 0
Trigger time out
— トリガ ステージでトリガ条件が発生する必要があるデータ キャプチャ IP コア クロック サイクルの最大数
1
(既定値) | 1 ~ 65,536 の整数
この多数のデータ キャプチャ IP コア クロック サイクル内で、このパラメーターを有効にしているトリガー ステージでトリガー条件が発生する必要があります。要件に応じて、1 ~ 65,536 の任意の整数値を指定できます。トリガーステージでトリガータイムアウトを有効にするには、このパラメーターを選択します。Trigger Stage 1ではトリガーのタイムアウトは許可されません。
Enable capture condition logic
— キャプチャ条件ロジックを有効にするオプション
off
(既定値) | on
データ キャプチャ IP コアのキャプチャ条件ロジックを有効にするには、このパラメーターを選択します。キャプチャ条件ロジックを有効にして、キャプチャ条件を使用して FPGA からどのデータをキャプチャするかを制御します。データ キャプチャ IP コアは、クロック サイクルごとにキャプチャ条件を評価し、キャプチャ条件を満たすデータのみをキャプチャします。取得条件の詳細については、捕獲条件を参照してください。
依存関係
このパラメーターを有効にするには、FPGA データ キャプチャ コンポーネント ジェネレーター ツールでInclude capture condition logicを選択します。
Signal
— キャプチャコンポーネント信号名
文字ベクトル
このパラメーターは読み取り専用です。生成時にトリガーとして指定した信号名が、下部のドロップダウン メニューにリストされます。+ボタンをクリックして、キャプチャ条件に信号を追加します。
依存関係
このパラメーターを有効にするには、 Enable capture condition logicを選択します。
Operator
— キャプチャ条件内の信号を比較する演算子
==
| !=
| <
| >
| <=
| >=
信号を比較するには、次の演算子のいずれかを選択します: ==
、 !=
、 <
、 >
、 <=
、または>=
。X
またはx
(ドントケア値) を含む信号を比較するには、 ==
または!=
を指定します。 $演算子。
依存関係
このパラメーターを有効にするには、 Enable capture condition logicを選択します。
Value
— 全体的なキャプチャ条件の一部として信号を比較する値
小数 | バイナリ | 16進数 | Low
| High
| Falling edge
| Rising edge
| Both edges
キャプチャ条件は、1 つ以上の信号の値の比較で構成できます。このパラメーターは、各信号に一致する値を指定します。
マルチビット信号の場合は、信号に関連付けられたデータ型の範囲内の 10 進数、2 進数、または 16 進数の値を指定します。16 進値または 2 進値を指定する場合、 X
またはx
(ドントケア値) を組み合わせて値を指定して、ビット マスキングを有効にすることができます。値を比較する際、キャプチャ条件はX
またはx
の位の値を破棄し、出力を提供します。
読みやすくするためにビットのグループを分離するには、ビット間に_
を使用できます。たとえば、32 ビットのバイナリ値を0b1010_XXXX_1011_XXXX_1110_XXXX_1111XXXX
として表し、32 ビットの 16 進値を0xAB_CDEXFX
として表すことができます。
boolean
信号の場合、レベルまたはエッジ条件を選択します。詳細については、捕獲条件を参照してください。
依存関係
このパラメーターを有効にするには、 Enable capture condition logicを選択します。
Capture condition combination operator
— キャプチャ条件作成用の論理演算子
AND
(既定値) | OR
このパラメーターは、ロジック ゲートのアイコンで示されます。[Change operator]ボタンをクリックして、 AND
とOR
を切り替えます。
キャプチャ条件は、1 つ以上の信号の値の比較で構成できます。これらの値の比較を 1 種類の論理演算子のみと組み合わせます。組み合わせ演算子を組み合わせて使用することはできません。詳細については、捕獲条件を参照してください。
依存関係
このパラメーターを有効にするには、 Enable capture condition logicを選択します。
Signal Name
— キャプチャされた信号名
文字ベクトル
このパラメーターは読み取り専用です。生成時に指定した値が反映されます。この名前は、構造体変数のフィールドの名前です。
Bit Width
— 信号内のビット数
正の整数
このパラメーターは読み取り専用です。生成時に指定した値が反映されます。
Data Type
— キャプチャされたデータのデータ型
内蔵タイプ | numerictype
Data Typeメニューには、キャプチャされた信号のビット幅に一致するデータ型の提案が表示されます。このサイズは、生成された IP 上のポートに指定した幅です。このフィールドに入力してカスタム データ型を指定できます。信号が 8、16、または 32 ビットの場合、デフォルトはuint
です。信号が 1 ビットの場合、デフォルトはboolean
です。信号の幅が異なる場合、デフォルトはnumerictype(0,bitWidth,0)
です。
このツールは、信号ビット幅に応じて、次のデータ型をサポートします: boolean
、 uint8
、 int8
、 uint16
、 int16
、 half
、 uint32
、 int32
、 single
、 uint64
、 int64
、 double
、およびnumerictype
。
バージョン履歴
R2017a で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)