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,则必须删除其中一个实例并重新实例化该算子。

[提示] 事件端口和单个事件的数量受限

设计中可用的最大事件端口数量取决于您所针对的目标硬件平台(详细信息请参阅 '支持的平台的设备资源')。

如果您设计用于运行时环境的小程序,则在一个设计中最多可以使用 64 个单个事件。

I/O Properties

财产 值
操作员类型 M
输入链接 I,负载数据的输入。
S,用于启动新事件的选通信号。

Supported Link Format

链接参数 输入链路 I 输入链路 S
Bit Width 16 1
Arithmetic 未签名 未签名
Parallelism 1 1
内核列 1 1
内核行 1 1
图像协议 {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D} {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format VAF_GRAY VAF_GRAY
颜色口味 FL_NONE FL_NONE
Max. Img Width 任何 任何
Max. Img Height 任何 任何

参数

EventsWithTimestamp
键入 静态/动态写入参数
默认 开启
范围 {ON,OFF}

定义是否为每个事件附加高精度 Timestamp。
ON:生成 Timestamp。
OFF:不生成 Timestamp。

EventName
键入 静态写入参数
默认 Event
范围

此事件名称用于在 Framegrabber SDK 中识别和使用特定的事件信号。

PayloadSize
键入 静态参数
默认 1
范围 [1, 254]

以 16 位数据字为单位设置有效负载大小。

AutoClear
键入 静态参数
默认 NONE
范围 {NONE, EoL, EoF}

Defines at which time clearance is done so another event can be triggered.

当设置为 EoL 时,在下一行结束之后,可以启动另一个事件。 一旦第 N 个数据准备就绪,在行结束之前将不再接受进一步的事件数据,无论 S 的状态如何。 从下一行开始,可以生成一个 S=1 的新事件。

当设置为 EoF 时,在下一帧结束之后,可以启动另一个事件。 一旦第 N 个数据准备就绪,在帧结束之前将不再接受进一步的事件数据,无论 S 的状态如何。 从下一帧开始,可以生成一个 S=1 的新事件。

当设置为 NONE 时,S 必须在事件选通后至少在一个数据周期内传输 0,以便激活随后可接受的事件数据。请注意,一旦 S 被取消断言,在当前事件的有效负载数据完成之前,不得再次断言它。