Operator EventToHost

Operator Library: Base

このオペレーターは、入力リンクの立ち上がりエッジに対してソフトウェアイベントを生成します。 オペレーターは、イベントを発生させることができる最大16個の入力ポートを備えています。

N個の入力すべて(最大16個)で、個別のイベントを生成できます。 このイベントには、シグナルリンクデータは含まれません。 通常、このオペレーターはGPIOのステータス監視や、特殊な状態の通知に使用されます。

各入力ポートは対応するイベントに関連付けられています。 イベントは、一意のイベント名(パラメーター EventName_(以下のパラメーター説明を参照))を使用して、ソフトウェアアプリケーションによって識別されます。

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

さらに、各入力ポートに対してEventIDタイプのリソースが予約されます。 EventIDは自動的に生成されるため、このリソースを変更することはできません(そのためグレー表示されます)。 コピー&ペーストによって異なるオペレーターインスタンスに同じEventIDが存在する場合は、これらのインスタンスのいずれかを削除し、 オペレーターを再インスタンス化する必要があります。

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

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

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

[ヒント] オペレーターのコピー&ペースト後

コピー&ペースト後、各EventPortと各EventIDがデザイン内で1回だけ使用されるようにリソースを調整する必要があります。

リソースを調整するには:

  1. ツールバーの [Resources] ボタンをクリックします。

    重複マッピングされているリソースが赤色で表示されます:

  2. デザイン内でまだ使用されていないイベントポートのEventPort番号を入力します:

    EventIDは編集不可で自動生成されるため、EventIDに新しい値を入力することはできません。

  3. OK ボタンをクリックします。次のメッセージが表示されます:

  4. Apply をクリックします。[Resources] ダイアログが閉じます。再度開くと、EventIDに対して一意の値が生成されていることが確認できます:

I/O Property

Property 値
オペレータータイプ M
Input Link I[000-015]、ソフトウェアイベントを発生させるための信号入力。

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

Link Parameter 入力リンク I[000-015]
Bit Width 1
Arithmetic unsigned
Parallelism 1
Kernel Columns 1
Kernel Rows 1
Img Protocol VALT_SIGNAL
Color Format VAF_GRAY
Color Flavor FL_NONE
Max. Img Width any
Max. Img Height any

パラメーター

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

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

EventName_[n]
タイプ static write parameter
Default EventName_[n]
範囲

すべてのイベント入力に、一意の識別子名を割り当てる必要があります。 このイベント名は、Framegrabber SDKで特定のハードウェアイベント信号を識別して使用するために使用されます。

使用例

EventToHostオペレーターの使用方法については、以下の例をご覧ください: