Operator EventToHost

Operator Library: Base

此 operator 會在其輸入連接為上升緣時產生軟體事件。 此 operator 提供最多 16 個可觸發事件的輸入連接埠。

所有 N 個輸入(最多 16 個)皆可產生個別事件。 該事件將不提供任何信號連接資料。 通常,此 operator 用於監控 GPIO 的狀態或發送特殊條件信號。

每個輸入連接埠皆與對應的事件相關聯。 軟體應用程式會使用唯一的事件名稱來識別事件 (參數 EventName_(請參閱下方參數說明))。

此 operator 專屬使用一個 EventPort 類型的資源。 您可以修改 EventPort 資源。 EventPort 會指定軟體使用哪一個事件通道。在同一個設計中,每個 EventPort 編號只能使用一次。

此外,會為每個輸入連接埠保留一個 EventID 類型的資源。 您無法修改此資源(因此以灰色顯示),因為 EventID 是自動產生的。 如果在不同的 operator 執行個體中透過複製與貼上(copy & paste)產生相同的 EventID,您需要刪除其中一個執行個體 並 重新執行 operator 執行個體化。

[提示] 有限數量的事件連接埠與個別事件

設計中可用的事件連接埠最大數量取決於您進行設計所針對的目標硬體平台 (詳細資訊請參閱附錄中的 ' Device Resources of Supported Platforms ' 節)。

如果您設計的 applet 是用於執行環境中,則在一個設計中最多可以使用 64 個個別事件。

[提示] 複製並貼上 operator 之後

在複製並貼上之後,您必須調整資源,以確保設計中的每個 EventPort 和每個 EvendID 都只使用一次。

若要調整資源:

  1. 按一下工具列中的 Resources 按鈕。

    對應過多的資源會以紅色顯示:

  2. 為設計中尚未使用的事件連接埠輸入 EventPort 編號:

    由於 EventID 無法編輯而是自動產生,因此您無法為 EventID 輸入新的值。

  3. 按一下 OK 按鈕。隨即會顯示下列訊息:

  4. 點擊 「套用」。此時「資源」對話方塊將關閉。若您重新開啟該對話方塊,將會發現針對這些事件 ID 已產生唯一的值:

I/O Properties

Property Value
Operator Type M
Input Link I[000-015],用於觸發軟體事件的訊號輸入。

支援的 Link 格式

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

參數

帶時間戳記的事件
Type 靜態/動態寫入參數
Default ON
Range {ON, OFF}

定義是否將高精確度 Timestamp 附加至每個事件。
ON = 產生 Timestamp。
OFF = 不產生 Timestamp。

EventName_[n]
Type 靜態寫入參數
Default EventName_[n]
Range

必須為每個事件輸入指定一個唯一的識別名稱。 此事件名稱用於在 Framegrabber SDK 中識別和使用特定的硬體 事件訊號。

使用範例

以下範例顯示了 EventToHost 運算子的使用方式: