オペレーター ImageMonitor

Operator Library: Debugging

オペレーター ImageMonitor は、定義した内部パイプラインの任意の場所から画像を取得します。 画像がその場所に到達するまでにどのような処理が施されたかを確認でき、この情報をデバッグに活用できます。

オペレーター ImageMonitor は、VisualApplets でデザインをシミュレーションする際に使用する Simulation Probe のように機能しますが、 オペレーター ImageMonitor は実行時テストに使用される点が異なります。

このオペレーターは、非常にシンプルな画像読み出しレジスタインターフェイスを提供します。Mode パラメータを image monitoring に設定すると、 PixelData レジスタを読み取るだけで、画像全体を読み出すことができます。

これにより、(限られた) DMA チャンネルの 1 つを使用せずに画像データをモニタリングできるため、非常に便利です。

デザイン内の ImageMonitor オペレーターのインスタンス数は理論上無制限です。 ただし、読み出し中のデータフローを一時停止するための追加の FPGA ロジックが導入されるため、リソースを節約するために慎重に使用する必要があります。 また、これは無限のソースのモニタリングにはこのオペレーターを使用できないことを意味します。

PixelData の下位 3 ビットには Valid、EndOfLine、および EndOfFrame フラグが含まれるため、サポートされるピクセル幅は最大 61 ビットに制限されます。

CurrXPos および CurrYPos パラメータは、現在アクティブなピクセル位置を指します。この情報を使用して出力ピクセルをフィルタリングできます(例: 2 ピクセルごとまたは 3 ピクセルごとのみを分析するなど)。

[重要] ランタイムテスト

この operator は、ランタイム時にデザインをテストおよび解析するように設計されています。 operator をデバッグに使用する前に、デザインをビルド(合成)し、ターゲットハードウェアにロードして、実際の画像処理を開始する必要があります。

この operator は、VisualApplets 内でのデザインシミュレーションを目的としたものではありません。

I/O Property

Property 値
オペレータータイプ M
Input Link I、画像データ入力

サポートされているリンクフォーマット

Link Parameter Input Link I
Bit Width [1, 61]
Arithmetic {unsigned, signed}
Parallelism any
Kernel Columns 1
Kernel Rows 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D}
Color Format any
Color Flavor any
Max. Img Width any
Max. Img Height any

パラメーター

モード
タイプ 動的書き込みパラメータ
Default UnlimitedSink
範囲 {UnlimitedSink, Monitor, MonitorFromLineStart, MonitorFromFrameStart}

このパラメータは動作モードを設定します。

UnlimitedSink = すべての入力が破棄されるため、モニタリングを行いません。

Monitor = すぐにモニタリングモードに切り替えます。

MonitorFromLineStart = 現在のラインの終了後にモニタリングモードに切り替えます。

MonitorFromFrameStart = 現在のフレームの終了後にモニタリングモードに切り替えます。

ReadyForMonitoring
タイプ 動的リードパラメータ
Default いいえ
範囲 {yes, no}

PixelData パラメータを読み取る準備ができていることを示します。PixelData は、yes に設定されている場合にのみ読み取る必要があります。

PixelData
タイプ 動的リードパラメータ
Default
範囲 [1, 64]

現在のピクセル値と 3 つのピクセルフラグが含まれます。valid フラグが設定されていない場合、ピクセル値は破棄されます。

PixelValue = PixelData[1, LinkBitWidth]

ValidFlag = PixelData[LinkBitWidth+1]

EndOfLineFlag =

PixelData[LinkBitWidth+2]

EndOfFrameFlag =

PixelData[LinkBitWidth+3]

CurrXPos
タイプ 動的リードパラメータ
Default 0
範囲 [0, MaxImageWidth-1]

現在のライン位置を表示します。

CurrYPos
タイプ 動的リードパラメータ
Default 0
範囲 [0, MaxImageHeight-1]

現在の画像高さ位置を表示します。

使用例

ImageMonitorオペレーターの使用方法は、以下の例に示されています。

  • 'Image Monitoring'

    例 - デバッグ目的でリンク上の画像転送状態を調査できます。