从网口读取

使用此工具从（服务器）套接字读取数据。

在 “URL” 参数中设置要读取的套接字，并通过将 “连接” 参数设为 1 建立连接。由于此工具会建立客户端连接，服务器必须可用。使用执行 MERLIC 一次的按钮 ，以单步执行此工具。此功能允许您逐步读取数据。

如果 “套接字句柄” 连接自前一个套接字工具，则所有参数将仅采用自第一个工具。因此，如果想要调整当前工具的参数设置，您必须在第一个工具中进行调整，否则参数更改将被忽略。

执行行为

此工具的执行行为不同于默认行为。通常，在以下情况下会执行 MERLIC 工具：

• MERLIC Vision App 在连续模式下显式执行。
• MERLIC Vision App 在“运行一次”模式下显式执行。
• 在 MERLIC Creator 中打开了包含该工具的 MERLIC Vision App。
• 在 MERLIC Creator 中更改了该工具的参数值。

不过，仅在以下情况下会执行工具 “从网口读取”：

• MERLIC Vision App 在连续模式下显式执行。
• MERLIC Vision App 在“运行一次”模式下显式执行。

这可以确保在加载 MVApp 或更改该工具的参数值时不应用读取和写入操作。但如果参数连接设为 1，则该工具仍会尝试与远程设备建立连接。

参数

基本参数

URL：

此参数定义了要写入的套接字的 URL。一个有效的 “URL” 包括要使用的协议、要连接的计算机主机名以及用冒号隔开的端口号，例如“tcp://localhost:4000”。

连接：

此参数定义与套接字的连接是激活还是停用。默认情况下，此参数设置为 0。这表示与套接字的连接未激活，因此未建立连接进行读取。如果要开始从套接字读取数据，您需要将参数设为 1 才能打开文件进行读取。

由于每次更改值都会执行工具，所以我们建议将“连接”参数设置为 0，直至该工具已完全配置。

超时：

此参数定义了写入超时。它以秒为单位并默认设为 0.5 秒。您可以在相应的连接器中更改 “超时”。

数据格式:

此参数定义了如何转换数据以供写入。这是必须的，因为数据以二进制包的形式发送。默认情况下设置为“z”。您可以在相应的连接器中更改其值。“数据格式”可包含一个或多个限定符，每个后面紧跟可选修饰符和重复计数。

整数值

值	描述
c	1 字节 = 8 位，已签署
C	1 字节 = 8 位，未签署
s	2 字节 = 16 位，已签署
S	2 字节 = 16 位，未签署
i	4 字节 = 32 位，已签署
I	4 字节 = 32 位，未签署
q	8 字节 = 64 位，已签署（仅在 64 位架构上可用）
Q	8 字节 = 64 位，未签署

浮点值

值	描述
f	浮点，4 字节 = 32 位
d	双精度浮点数，8 字节 = 64 位

字符串值

值	描述
A	字符串（默认长度为 1024 字节），使用空格填充。
z	长度可变的字符串，长度修饰符指定最大长度（默认长度为 1024 字节）。
Z	A 字符串（默认长度为 1024 字节），使用零填充并且在发送时以零终结。

不需要值作为数据格式的特殊字符

值	描述
-	零字节会被跳过。
_	空格字节会被跳过。

可在以上限定符之一后面使用的修饰符

值	描述
n	网络字节序。此修饰符在从网络字节序（大端序）读取到主机字节序时转换整数或浮点值。 它还可用作格式字符串中的第一个字符。
N	此修饰符在从 intel 字节序（小端序）读取到主机字节序时转换整数或浮点值。 它还可用作格式字符串中的第一个字符。

用于前置限定符的重复计数

值	描述
n	如果使用整数和实数值，此计数器会定义前置限定符的重复频率，例如，如果 n=5，则“c5”表示“ccccc”。 您可为 n 使用任何整数值。如果使用字符串值，n 表示字符串的大小，例如，“A2”表示大小为 2 个字节的字符串。 如果要发送包含两个字符串的元组，您必须重复限定符，例如，“AA”或“zz”。在接收套接字中，使用单一限定符即足以定义数据格式（例如，“z”）以读取字符串。

其他参数

套接字句柄：

此参数可用于指定从前一工具（套接字句柄已定义）读取数据的套接字的句柄。如果已设置套接字句柄，则将从前一工具采用 URL 和超时。

结果

基本结果

数据：

此结果包含从套接字读取的数据。可能为整数、实数或字符串值。

工具状态：

“工具状态”返回有关工具状态的信息，因此可用于处理错误。请参阅主题工具状态结果，了解关于不同工具状态结果的更多信息。

其他结果

使用的套接字句柄：

此参数代表从中读取数据的套接字的句柄。它可被后续工具用于写入或读取。应避免几个工具使用相同的句柄同时读取或写入同一套接字，否则可能会导致意外效果。

发送方：

此结果包含套接字的 IP 地址或主机名和端口。

处理时间:

此结果返回最近一次执行工具的持续时间（以毫秒为单位）。该结果作为附加结果提供。因此，默认情况下它是隐藏的，但是可以通过工具结果旁边的 按钮显示。有关更多信息，处理时间请参工具参考中所阅部分。