オペレーター ImageTimingGenerator

Operator Library: Debugging

オペレーター ImageTimingGeneratorを使用すると、実際のシステムのリアルカメラで発生するような画像タイミングをエミュレートできます。

このオペレーターは、黒画像の出力を生成します。画像出力のタイミング動作を定義できる多くのパラメータを提供します。

このオペレーターを使用して、後続の画像処理パイプラインがデータストリームの特定のタイミングを処理できるかどうかをテストします。

特定のタイミング動作がボトルネックを引き起こすか、あるいはタイミングの逸脱に関係なくデザインのパイプラインで画像を処理できるかどうかを確認できます。

ライン生成設定とフレーム生成設定では、4つの異なる生成モードがサポートされています。

  • FreeRun: FreeRunモードは、最も高速な生成を実現します。
  • JitterMode: JitterModeはFreeRunモードと同様に機能しますが、タイミング生成のジッターを定義できます。
  • FixedFreqency: FixedFreqency生成モードでは、固定のタイミングを設定できます。
  • ExternalTrigger: 入力信号を使用してラインおよび/またはフレーム生成をトリガーする場合は、ラインおよび/またはフレーム生成設定をExternalTriggerモードに設定します。

さらに、画像高さ、画像幅、ラインギャップ、フレームギャップの変動に対してデザインがどのように反応するかをテストできます。これらのパラメータは、ルックアップテーブルおよび可変ジッター設定を介して定義できます。

ピクセルデューティサイクルを調整して、仮想ピクセルクロックの減速をシミュレートすることもできます。

ImageHeightJitterおよびFrameGapJitterは、FrameGenerationModeがJitterModeに設定されている場合にのみアクティブになります(使用できます)。同様に、ImageWidthJitterおよびLineGapJitterは、LineGenerationMode = JitterModeの間のみアクティブになります。

フレーム生成パラメータおよびImageHeightパラメータは、VALT_IMAGE2D画像出力プロトコルでのみ使用できます。また、すべてのライン生成パラメータおよびImageWidthパラメータは、VALT_IMAGE2DまたはVALT_LINE1D画像出力プロトコルでのみ使用できます。

[注] デザインシミュレーション中の動作(ビルド前)

デザインシミュレーション中には、パラメータ ImageHeightLut、ImageWidthLut、MaxImageSequenceLength、および ImageSequenceLengthのみが使用されます。このオペレーターの他のすべてのオペレーターパラメータとLUTエントリは、シミュレートされた画像に影響を与えません。つまり、シミュレーション中、オペレーター ImageTimingGeneratorはオペレーター CreateBlackImageのように動作します。

このオペレーターの他のすべてのオペレーターパラメータとLUTエントリは、シミュレートされた画像に影響を与えません(つまり、シミュレーション中、オペレーター ImageTimingGeneratorはオペレーター CreateBlackImageのように動作します)。

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

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

I/O Property

Property 値
オペレータータイプ M
入力リンク TriggerLineI(オプション)、オプションの外部ライントリガー信号入力。使用しない場合はグランドに接続してください。
TriggerFrameI(オプション)、オプションの外部フレームトリガー信号入力。使用しない場合はグランドに接続してください。
Output Link O、画像データ出力

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

Link Parameter 入力リンク TriggerLineI(オプション) 入力リンク TriggerFrameI(オプション) Output Link O
Bit Width 1 1 1
Arithmetic なし なし unsigned
Parallelism なし なし any
Kernel Columns なし なし 1
Kernel Rows なし なし 1
Img Protocol 信号 信号 {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format なし なし GRAY
Color Flavor なし なし なし
Max. Img Width なし なし any
Max. Img Height なし なし any

パラメーター

MaxImageSequenceLength
タイプ static write parameter
Default 1
範囲 [1, (2^14)-1]

ImageHeightLUT、ImageWidthLUT、FrameGapLUT、およびLineGapLUTのLUTサイズを定義します。

ImageSequenceLength
タイプ 動的書き込みパラメータ
Default 1
範囲 [1, (2^MaxImageSequenceLength)-1 ]

LUTから使用されるエントリ数を設定します。 1に設定した場合、各LUTの最初のエントリのみが使用されます。 たとえば、MaxImageSequenceLengthが7に設定されているときに4などに設定した場合、 すべてのLUT内の最初の4つのエントリのみがラウンドロビン方式で使用されます。

ImageHeightLUT
タイプ 動的書き込みパラメータ
Default 1024
範囲 [1, MaxImageHeight]

出力画像の生成に使用される画像の高さの値を格納するLUTです。生成中、LUTの値はラウンドロビン方式で読み取られます。

ImageHeightJitter
タイプ 動的書き込みパラメータ
Default 0
範囲 [0, MaxImageHeightBitwidth-2]

画像生成中にジッターが許可されるImageHeightLUT値の最下位ビット数。パラメータFrameGenerationModeがJitterModeに設定されている場合にのみ使用されます。

ImageWidthLUT
タイプ 動的書き込みパラメータ
Default 1024
範囲 [1, MaxImageWidth]

出力画像の生成に使用される画像の幅の値を格納するLUTです。生成中、LUTの値はラウンドロビン方式で読み取られます。

ImageWidthJitter
タイプ 動的書き込みパラメータ
Default 0
範囲 [0, MaxImageWidthBitwidth-2]

画像生成中にジッターが許可されるImageWidthLUT値の最下位ビット数。パラメータLineGeneration ModeがJitterModeに設定されている場合にのみ使用されます。

PixelDutyCycle
タイプ 動的書き込みパラメータ
Default 100
範囲 [1, 100]

出力ストリームのピクセルデューティサイクル。100%は、すべてのクロックサイクルが出力ピクセルに対応することを意味します。20%のピクセルデューティサイクルが設定されている場合、5クロックサイクルごとに1つの出力ピクセルが生成されます。

FrameGenerationMode
タイプ 動的書き込みパラメータ
Default FreeRun
範囲 {FreeRun, JitterMode, FixedFrequency, ExternalTrigger}

フレーム生成モードを選択します。

FreeRun: ImageHeightとFrameGapに基づく最速の画像生成モード。パラメータFrameRateは無視されます。

JitterMode: FreeRunと同じですが、FrameGapJitterパラメータを使用します。

FixedFrequency: FrameRateパラメータによって設定された固定周波数の画像レートの生成。

ExternalTrigger: 新しい画像フレームの生成の開始をトリガーするために、オプションの外部トリガー入力TriggerFrameIが使用されます。ポートFrameTriggerIが有効になっている場合にのみ使用できます。

現在の画像生成が終了する前に新しい画像の開始がトリガーされた場合、この要求は無視され、SkippedFrame Counterがインクリメントされます。これはすべてのフレーム生成モードに適用されます。

FrameRate
タイプ 動的書き込みパラメータ
Default 10
範囲 [0.5, 1048576.0]

Hz単位のターゲット画像周波数。パラメータFrameGenerationModeがFixedFrequencyに設定されている場合にのみ使用されます。最大FrameRateはLineRateとImageHeightによって制限されます。

FrameGapLUT
タイプ 動的書き込みパラメータ
Default 1024
範囲 [1, 67108863]

Lookup tableのエントリによって、2つの画像フレーム間のギャップが定義されます。フレームギャップの値は、クロックサイクル数としてのギャップを定義します。このパラメータは、FixedFrequency生成モードでは無視されます。

FrameGapJitter
タイプ 動的書き込みパラメータ
Default 0
範囲 [0, FrameGapBitwidth-2]

画像生成中にジッターの発生が許可される、FrameGapLUT値の下位ビット数です。JitterModeでの画像生成時にのみ使用されます。

LineGenerationMode
タイプ 動的書き込みパラメータ
Default FreeRun
範囲 {FreeRun, JitterMode, FixedFrequency, ExternalTrigger}

ライン生成モードを選択します。

FreeRun: ImageWidthおよびLineGapに基づく、最速の画像生成モードです。LineRateパラメータは無視されます。

JitterMode: LineGapJitterパラメータを使用する点を除き、FreeRunと同じです。

FixedFrequency: LineRateパラメータで設定された固定周波数のラインレートを生成します。

ExternalTrigger: オプションの外部トリガー入力TriggerLineIを使用して、新しいライン生成の開始をトリガーします。ポートLineTriggerIが有効になっている場合のみ使用できます。

現在のライン生成が終了していない状態で新しいラインの開始がトリガーされた場合、この要求は無視され、SkippedLine Counterがインクリメントされます。これはすべてのライン生成モードに適用されます。

LineRate
タイプ 動的書き込みパラメータ
Default 10
範囲 [0.5, 1048576.0]

Hz単位のターゲットライン周波数。FixedFrequencyライン生成モードでのみ使用されます。最大LineRateはLineGapとImageWidthによって制限されます。

LineGapLUT
タイプ 動的書き込みパラメータ
Default 1024
範囲 [1, 67108863]

Lookup tableのエントリによって、2つのライン間のギャップが定義されます。ラインギャップの値は、2つのライン間の画素数としてのギャップを定義します。このパラメータは、FixedFrequencyライン生成モードでは無視されます。

LineGapJitter
タイプ 動的書き込みパラメータ
Default 0
範囲 [0, LineGapBitwidth-2]

画像生成中にジッターの発生が許可される、LineGapLUT値の下位ビット数です。JitterModeでのライン生成時にのみ使用されます。

SkippedLine
タイプ 動的リードパラメータ
Default 0
範囲 [0, 65535]

ライン生成モードにおける設定の競合を示すために使用されるエラーCounterです。

現在のライン生成が終了していない状態で新しいラインの開始がトリガーされた場合、この要求は無視され、SkippedLine Counterがインクリメントされます。これはすべてのライン生成モードに適用されます。

SkippedFrame
タイプ 動的リードパラメータ
Default 0
範囲 [0, 65535]

フレーム生成モードにおける設定の競合を示すために使用されるエラーCounterです。

現在の画像生成が終了していない状態で新しい画像の開始がトリガーされた場合、この要求は無視され、SkippedFrame Counterがインクリメントされます。これはすべてのフレーム生成モードに適用されます。

LinesToSimulate
タイプ static write parameter
Default 1
範囲 [1, (2^32) - 1]

出力リンクの画像プロトコルがVALT_LINE1Dに設定されている場合は、シミュレーション用のライン数を指定する必要があります。このパラメータは、シミュレーション画像高さを指定するために使用されます。1Dシミュレーションの詳細については、「Simulation」を参照してください。このパラメータは、出力画像プロトコルがVALT_LINE1Dに設定されている場合にのみ変更できます。

PixelsToSimulate
タイプ static write parameter
Default 1
範囲 [1, (2^32) - 1], ステップサイズ = 出力 Parallelism

出力リンクの画像プロトコルが VALT_PIXEL0D に設定されている場合、シミュレーション用のピクセルストリームサイズを指定する必要があります。このパラメータは、シミュレーションのピクセルストリーム幅を指定するために使用されます。0D シミュレーションの詳細については、「Simulation」を参照してください。このパラメータは、出力画像プロトコルが VALT_PIXEL0D に設定されている場合にのみ変更できます。

使用例

ImageTimingGenerator オペレータの使用方法については、以下の例を参照してください。

  • 'Image Timing Generator'

    例 - ジェネレータによって画像タイミングが提供されている間、デザインのデータフローを解析できます。

  • 'Image Flow Control'

    例 - ハードウェアにおける設計の内部データフロー制御のデバッグおよび潜在的な補正を目的としています。