Operator EventDataToHost

Operator Library: Base

此運算子會產生帶有資料酬載的軟體事件。 酬載大小可透過 PayloadSize 參數設定為 N 個 16 位元資料字。具體來說,

此運算子具有一個 16 位元資料輸入 I 以及一個 1 位元選通信號輸入 S。這些輸入為 O 同步。 輸入 S 會啟動一個新事件。在 S 確立之前到達 I 的任何資料都會被忽略。 S 可能會維持確立狀態多個資料週期,但一旦 S 取消確立,在進行中事件的酬載資料完成之前,不得再次將其確立。 如果設定了自動清除(請參閱參數 AutoClear),則 S 甚至可以持續為 1。

參數 AutoClear 定義了執行清除的時間點,以便能觸發另一個事件:

  • EoL:可在下一個行結束後啟動另一個事件。一旦第 N 個資料準備就緒,就不會再接受進一步的事件資料,直到行結束為止,這與 S 的狀態無關。從下一行開始,可以使用 S=1 產生新事件。

  • EoF:可在下一個影格結束後啟動另一個事件。一旦第 N 個資料準備就緒,就不會再接受進一步的事件資料,直到影格結束為止,這與 S 的狀態無關。從下一個影格開始,可以使用 S=1 產生新事件。

  • NONE:無自動清除。在事件選通之後,S 必須傳輸至少一個資料週期的 0,以啟用隨後要接受的事件資料。請注意,一旦 S 取消確立,在進行中事件的酬載資料完成之前,不得再次將其確立。

當從 I 接收到 N 個資料字時,運算子會儲存資料酬載並觸發事件。 如果在發生自動清除時事件資料不完整,則不會產生任何事件,且不完整的酬載資料會被刪除。

運算子的輸入絕不會被阻塞。由於事件傳輸緩衝區的容量有限,當事件速率過高時可能會發生溢位。為了偵測資料遺失,在事件資料中包含流水號可能會很有用。

軟體應用程式透過 EventName 參數使用唯一的事件名稱來識別觸發的事件(請參閱下方的參數說明)。

運算子獨佔使用一個類型為 EventPort 的資源。 您可以修改資源 EventPort。 EventPort 指定軟體使用哪個事件通道。每個 EventPort 編號在設計中只能使用一次。

此外,保留了一個類型為 EventID 的資源。 您無法修改此資源(因此它呈現灰色),因為 EventID 是自動產生的。 如果您複製並貼上運算子執行個體,因而使不同的運算子執行個體中具有相同的 EventID,您必須刪除其中一個執行個體並重新實例化該運算子。

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

設計中可用的事件連接埠最大數量取決於您正在設計時所針對的目標硬體平台(詳細資訊請參閱 '支援平台的裝置資源')。

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

I/O Properties

Property Value
Operator Type M
輸入連結 I,酬載資料的輸入。
S,啟動新事件的選通信號。

支援的 Link 格式

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

參數

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

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

EventName
Type 靜態寫入參數
Default Event
Range

此事件名稱用於在 Framegrabber SDK 中識別和使用特定的事件訊號。

PayloadSize
Type static parameter
Default 1
Range [1, 254]

將酬載大小設定為 16 位元資料字的數量。

AutoClear
Type static parameter
Default NONE
Range {NONE, EoL, EoF}

定義執行清除的時間點,以便能觸發另一個事件。

設定 EoL 時,可在下一個行結束後啟動另一個事件。 一旦第 N 個資料準備就緒,就不會再接受進一步的事件資料,直到行結束為止,這與 S 的狀態無關。 從下一行開始,可以使用 S=1 產生新事件。

設定 EoF 時,可在下一個影格結束後啟動另一個事件。 一旦第 N 個資料準備就緒,就不會再接受進一步的事件資料,直到影格結束為止,這與 S 的狀態無關。 從下一個影格開始,可以使用 S=1 產生新事件。

設定 NONE 時,在事件選通之後,S 必須傳輸至少一個資料週期的 0,以啟用隨後要接受的事件資料。請注意,一旦 S 取消確立,在進行中事件的酬載資料完成之前,不得再次將其確立。