Operator EventDataToHost

Operator Library: Base

このオペレーターは、データペイロード付きのソフトウェアイベントを生成します。 ペイロードサイズは、PayloadSizeパラメータを使用して、N個の16ビットデータワードとして設定できます。

オペレーターには、16ビットのデータ入力Iと1性のストロボ入力Sがあります。これらの入力はO同期です。 入力Sは新しいイベントを開始します。Sがアサートされる前にIに到着したデータはすべて無視されます。 Sは1つのデータサイクルを超えてアサートされる場合がありますが、いったんSがネゲートされた後は、進行中のイベントのペイロードデータが完了するまで再アサートすることはできません。 自動クリアが設定されている場合(パラメータAutoClearを参照)、Sを常に1にすることも可能です。

パラメータAutoClearは、次のイベントをトリガーできるようにクリアを実行するタイミングを定義します。

  • EoL: 次の行の終了後に別のイベントを開始できます。N番目のデータの準備ができると、Sの状態に関係なく、行の終了までそれ以上のイベントデータは受け付けられません。次の行から、S=1で新しいイベントを生成できます。

  • EoF: 次のフレームの終了後に別のイベントを開始できます。N番目のデータの準備ができると、Sの状態に関係なく、フレームの終了までそれ以上のイベントデータは受け付けられません。次のフレームから、S=1で新しいイベントを生成できます。

  • NONE: 自動クリアなし。後続イベントのイベントデータの受け付けを有効にするには、イベントストロボの後に、Sが少なくとも1つのデータサイクルにわたって0を転送する必要があります。Sがネゲートされると、進行中のイベントのペイロードデータが完了するまで再アサートできないことに注意してください。

オペレーターはデータペイロードを保存し、IからNワードのデータを受信するとすぐにイベントをトリガーします。 自動クリアが発生した時点でイベントデータが不完全な場合、イベントは生成されず、不完全なペイロードデータは削除されます。

オペレーターの入力がブロックされることはありません。イベント転送バッファの容量には制限があるため、イベントレートが高すぎるとオーバーフローが発生する可能性があります。データ損失を検出するには、イベントデータにシーケンス番号を含めると便利です。

トリガーされたイベントは、EventNameパラメータ(以下のパラメータ説明を参照)を使用して、一意のイベント名によりソフトウェアアプリケーションで識別されます。

オペレーターは、EventPortタイプのリソースを排他的に使用します。 リソースEventPortを変更できます。 EventPortは、ソフトウェアで使用されるイベントチャネルを指定します。各EventPort番号は、デザイン内で1回のみ使用できます。

さらに、EventIDタイプの1つのリソースが予約されます。 EventIDは自動的に生成されるため、このリソースを変更することはできません(したがってグレー表示されます)。 オペレーターインスタンスをコピー&ペーストして異なるオペレーターインスタンスで同じEventIDを持つことになった場合は、これらのインスタンスの1つを削除し、オペレーターを新しくインスタンス化する必要があります。

[ヒント] イベントポートおよび個別イベントの制限数

デザインで使用可能なイベントポートの最大数は、設計対象のターゲットハードウェアプラットフォームによって異なります(詳細については、'サポートされているプラットフォームのデバイスリソース'を参照してください)。

ランタイム環境で使用するアプレットを設計する場合、デザイン内で最大64個の個別イベントを使用できます。

I/O Property

Property 値
オペレータータイプ M
入力リンク I、ペイロードデータの入力。
S、新しいイベントを開始するためのストロボ。

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

Link Parameter Input Link I 入力リンクS
Bit Width 16 1
Arithmetic unsigned unsigned
Parallelism 1 1
Kernel Columns 1 1
Kernel Rows 1 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D} {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format VAF_GRAY VAF_GRAY
Color Flavor FL_NONE FL_NONE
Max. Img Width any any
Max. Img Height any any

パラメーター

EventsWithTimestamp
タイプ 静的/動的書き込みパラメータ
Default ON
範囲 {ON,OFF}

高精度Timestampが各イベントに付加されるかどうかを定義します。
ON: Timestampが生成されます。
OFF: Timestampは生成されません。

EventName
タイプ static write parameter
Default Event
範囲

このイベント名は、Framegrabber SDKで特定のイベント信号を識別し、使用するために使用されます。

PayloadSize
タイプ static パラメータ
Default 1
範囲 [1, 254]

ペイロードサイズを16ビットデータワードの数として設定します。

AutoClear
タイプ static パラメータ
Default NONE
範囲 {NONE, EoL, EoF}

別のイベントをトリガーできるようにクリアランスを行うタイミングを定義します。

EoLが設定されている場合、次の行の終了後に別のイベントを開始できます。 N番目のデータの準備ができると、Sの状態に関係なく、行の終了までそれ以上のイベントデータは受け付けられません。 次の行から、S=1で新しいイベントを生成できます。

EoFが設定されている場合、次のフレームの終了後に別のイベントを開始できます。 N番目のデータの準備ができると、Sの状態に関係なく、フレームの終了までそれ以上のイベントデータは受け付けられません。 次のフレームから、S=1で新しいイベントを生成できます。

NONEが設定されている場合、後続イベントのイベントデータを受け付けるようにアクティブ化するには、イベントストロボの後にSが少なくとも1つのデータサイクルで0を転送する必要があります。Sのデアサート後は、進行中のイベントのペイロードデータが完了するまで再アサートできないことに注意してください。