Operator EventDataToHost

Operator Library: Base

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

此運算子具有一個 16 位元資料輸入 I 以及一個 1 E 位元選通信號輸入 S。這些輸入為 O 同步。 輸入 S 會啟動一個新事件。在 S 態為有效 (asserted) 之前到達 I 的任何資料都會被忽略。 S 可能在多個資料週期中保持有效,但一旦 S 變為無效 (de-asserted),在進行中事件的酬載資料完成之前,不得再次將其設為有效。 如果設定了自動清除(請參閱參數 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
Input Links I,酬載資料輸入。
S,用於啟動新事件的選通信號。

Supported Link Format

Link Parameter Input Link I 輸入連結 S
Bit Width 16 1
Arithmetic 無號數 無號數
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

Parameters

EventsWithTimestamp
Type static/dymanic 寫入參數
Default ON
Range {ON,OFF}

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

EventName
Type 靜態寫入參數
Default 事件
Range

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

PayloadSize
Type 靜態參數
Default 1
Range [1, 254]

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

AutoClear
Type 靜態參數
Default NONE
Range {NONE, EoL, EoF}

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

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

設定 EoF 時,可在下一個畫面結尾之後啟動另一個事件。 一旦第 N 個資料備妥,即不再接受進一步的事件資料,直到畫面結尾為止,這與 S 的狀態無關。 從下一個畫面開始,可以透過 S=1 產生新事件。

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