从串口读取

使用此工具从串口读取数据。

尝试连接串行接口前，请确保您获得所需的授权。

从 “端口名称” 参数中选择要读取的设备，并通过将 “连接” 参数设为 1 来建立与接口的连接。使用执行 MERLIC 一次的按钮 ，以单步执行此工具。此功能允许您逐步读取数据。

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

执行行为

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

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

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

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

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

参数

基本参数

端口名称：

此参数定义了从中读取数据的设备名称。默认情况下设置为“COM3”。端口名称是操作系统相关的。在 Windows 机器上，通常使用“COM1”-“COM4”端口。但是，您也可以通过在连接器的输入字段中键入所需的端口名称以更改其值。

连接：

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

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

按周期读取访问：

此参数定义了执行 MERLIC Vision App一次所允许的读取访问数量，即读取多少字符。默认情况下，此参数设置为 1。

波特率:

此参数确定了串口的输入和输出速度。默认情况下设置为 9600。您可以在相应的连接器中更改 “波特率”。

数据位数：

此参数定义了已发送的数据位数。默认情况下，此参数设置为 0。您可以在相应的连接器中更改“数据位数”。

停止位数：

此参数定义了已发送的停止位数。默认情况下，此参数设置为 0。您可以在相应的连接器中更改“停止位数”。

周期超时：

此参数定义了执行 MERLIC Vision App一次所在周期的读取超时。它以秒为单位并默认设为 0.1 秒。您可以在相应的连接器中将超时更改为 0 和 1 之间的值。

读取访问超时：

此参数定义了单个读取访问的读取超时。它以秒为单位并默认设为 0.1 秒。您可以在相应的连接器中将超时更改为 0 和 1 之间的值。

其他参数

串口句柄：

此参数可用于指定从前一工具（已定义串口句柄）读取数据的串口的句柄。

流控制:

此参数确定应使用何种数据流控制。默认情况下设置为“不变”。您可以在相应的连接器中更改流控制类型。

值	描述
无	未使用流程控制。
cts_rts	使用了硬件控制。
dtr_dsr	使用了硬件控制。
xon_xoff	使用了软件控制。
dtr_dsr xon_xoff	使用了硬件控制和软件控制的组合。
cts_rts xon_xoff	使用了硬件控制和软件控制的组合。
cts_rts dtr_dsr	使用了硬件控制的组合。
cts_rts dtr_dsr xon_xoff	使用了硬件控制和软件控制的组合。
不变	使用了当前的流程控制。

奇偶校验：

此参数定义了对传送数据执行何种奇偶校验检查。默认情况下设置为“不变”。您可以在相应的连接器中更改其值。

值	描述
无	不执行奇偶校验检查。
奇	检查，如果值为一的数据中位数是奇数。
偶	检查，如果值为一的数据中位数是偶数。
不变	使用当前奇偶校验检查类型。

结果

基本结果

数据：

此结果包含从串口读取的整数形式的数据。

工具状态：

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

其他结果

字符串数据：

此结果返回从串口读取的字符串数据。读取的数据将自动从字节转换为一个字符串。这样，除了作为整数返回的数据结果外，您还可以访问字符串数据。请注意，如果读取了一个空字符 (0x00)，则该符号不会转换成一个字符串，并将被忽略。

使用的串口句柄：

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

处理时间:

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