Modbus Poll中文用户手册（2023/08/01）版

Witte Software® https://www.modbustools.com

2023-08-01

1.Modbus Poll

Modbus Poll 是一款易于使用的 Modbus 主站模拟器，专为多种用途而开发。其中：

• Modbus 从设备设计者可快速轻松地测试协议接口
• 需要现场测试Modbus设备或网络的自动化工程师
• 想要从设备读取和/或更改特定服务数据的服务工程师
• 更改从设备中的 Modbus 寄存器
• 来自 Modbus 设备的日志数据
• 故障排除和合规性测试

1.1. Modbus 轮询的系统要求

硬件要求

处理器; 建议 1 GHz 或更快
1 GB RAM
5 MB 可用硬盘空间
1024 x 768 显示分辨率操作系统要求

支持从 Windows 7 到 Windows 11 的所有 Windows 版本。
Modbus Poll 版本 7 在 Windows XP 上运行。

1.1.1. 静默安装

静默安装不需要用户干预，并且没有用户界面。用户看不到任何对话框，也不会被问到任何问题。
使用命令行 /S 开关。

1.2. 终止用户许可协议

在使用 Modbus Poll 之前，您应仔细阅读以下条款和条件。除非您有 Witte Software 签署的不同许可协议，否则您使用本软件即表示您接受本许可协议和保证。如果您不接受这些条款，您必须立即停止使用该软件。

版权。
Modbus Poll（“软件”）版权所有 2002-2023，归 Witte Software 所有，保留所有权利。

评估和注册。
这不是免费软件。您特此被许可在 30 天内免费使用本软件进行评估。

如果您在 30 天评估期后使用本软件，则需要支付注册费。

30 天评估期后未经注册使用本软件将违反美国和国际版权法。

本软件的一份注册副本可以由在一台或多台计算机上个人使用该软件的一个人使用，也可以安装在由多人使用的一台计算机上，但不能同时安装在这两种计算机上。

有关订单和定价的信息，请访问https://www.modbustools.com/order.html

Modbus Poll 许可证是永久的。一旦您购买了特定主要版本的许可证，并且只要遵守许可协议，您就可以永久使用该版本，无需额外费用。

分配。
如果您不包含您的许可证密钥，您将被授权复制本软件；向任何人提供原件的精确副本；并通过电子方式分发未经修改的软件。特别禁止您对任何此类副本收费。

有限保修。
本软件按原样提供，WITTE SOFTWARE 不承担与本软件相关的所有明示或默示保证，包括但不限于适销性和特定用途适用性的任何默示保证。

损害赔偿限制。
对于因使用或无法使用该软件而造成的任何间接、后果性或附带损害，WITTE SOFTWARE 或参与该软件的创建、生产或交付的任何人均不承担责任，即使 WITTE SOFTWARE 已被告知这种可能性此类损害或索赔。在任何情况下，无论索赔形式如何，WITTE SOFTWARE 对任何损害的责任均不超过为使用本软件的许可所支付的价格。使用该软件的人承担与该软件的质量和性能相关的所有风险。

2. Modbus 轮询功能

2.1. 连接

Modbus Poll 使用以下方式从设备读取/写入数据：

• RS232 或 RS485 网络上的 Modbus RTU 或 ASCII。(USB/RS232/485转换器)
• Modbus TCP/IP
• TCP/IP 上的 Modbus。（Modbus RTU/ASCII封装在TCP数据包中）
• 协议UDP/IP
• 基于 UDP/IP 的 Modbus。（Modbus RTU/ASCII封装在UDP数据包中）

2.2. 支持的 Modbus 功能

• 01 (0x01) 读取线圈
• 02 (0x02) 读取离散输入
• 03 (0x03) 读取保持寄存器
• 04 (0x04) 读取输入寄存器
• 05 (0x05) 写单个线圈
• 06 (0x06) 写单个寄存器
• 08 (0x08) 诊断（仅限串行线）
• 11 (0x0B) 获取通讯事件计数器（仅限串行线）
• 15 (0x0F) 写入多个线圈
• 16 (0x10) 写入多个寄存器
• 17 (0x11) 报告服务器 ID（仅限串行线路）
• 22 (0x16) 掩码写寄存器
• 23 (0x17) 读/写多个寄存器
• 43 / 14 (0x2B / 0x0E) 读取设备标识

2.3. 数据记录

• 将数据记录到文本文件
• 将数据直接记录到 Excel 中

2.4. 显示格式

每个单元格都可以单独格式化。

• 有符号 16 位寄存器
• 无符号 16 位寄存器
• 十六进制
• 二进制
• 具有任意字/字节顺序的 32 位有符号整数
• 具有任意字/字节顺序的 32 位无符号整数
• 具有任意字/字节顺序的 64 位有符号整数
• 具有任意字/字节顺序的 64 位无符号整数
• 具有任意字/字节顺序的 32 位浮点数
• 具有任意字/字节顺序的 64 位双浮点

2.5. 其他功能

• 用于与 Excel VBA、Python 等连接的 OLE/自动化。
• 数据流量监控
• 打印和打印预览
• 字体选择
• 条件颜色
• 缩放
• 实时图表
• 保存/打开工作区
• 地址扫描

3. 概述

Modbus Poll 使用多文档接口。这意味着可以打开多个窗口。每一个同时具有来自不同从设备的不同数据内容。

这张照片显示了两个打开的窗户。一次读取来自从机 id 1 的 10 个保持寄存器，另一次读取来自从机 id 2 的 10 个保持寄存器。

3.1. 随时随地提供帮助

按 F1即可获取与当前所选项目相关的主题的上下文相关帮助。

SHIFT + F1调用特殊的“帮助模式”，其中光标变成帮助光标（箭头+问号）。然后，用户可以选择用户界面中的可见对象，例如菜单项、工具栏按钮或窗口。这将打开有关描述所选项目的主题的帮助。

3.2. 命名单元格

您可以在此处键入任何文本来指定值单元格。您还可以从 Excel 单元格复制/粘贴文本。

3.3. 值单元格

显示 Modbus 寄存器的数据值。如果双击值单元格，将出现一个对话框，您可以将新值写入从设备。在值单元格中键入数字也会显示该对话框。可以选择用于写入值的 Modbus 功能。

“响应成功时关闭对话框”复选框用于在成功发送值时自动关闭对话框。当要更改大量值时，这很方便。这样，可以快速选择新单元格，然后再次键入新值。

3.4. 更改字体

要更改字体，您有 2 个选项

• 选择要更改的单元格，然后右键单击。
• 选择要更改的单元格，然后菜单→显示→字体。

3.5. 条件颜色

条件颜色可帮助您直观地显示特定范围内的值。3 种颜色选择

• 默认颜色：如果没有任何条件颜色计算结果为 true，则使用此颜色。
• 规则 1：如果表达式的计算结果为 true，则使用此颜色选择。规则 1 优先于规则 2。
• 规则 2：如果表达式的计算结果为 true，则使用此颜色选择。

7 比较运算符

• 不曾用过
• 等于
• 比…更棒
• 少于
• 大于或等于
• 小于或等于
• 和

当数据类型为 float 或 32 位 long 类型时，不能使用“and”运算符。如果选择“and”，则条件值将以十六进制数字形式输入。如果单元格和条件值中的任何位均为 1，则其计算结果为 true。

3.5.1. 颜色示例

如果单元格值介于 398 和 402 之间，则为绿色

3.6. 缩放

缩放可帮助您将原始值缩放为人类可读的值。缩放仅适用于有符号和无符号 16/32 位整数。

(X1,Y1) 和 (X2,Y2)

穿过两点 (X1,Y1) 和 (X2,Y2) 的直线

Slope=m=Y2−Y1X2−X1

直线方程

Y=m⋅(X−X1)+Y1

精确小数点后的位数。使能够

必须启用才能缩放来自 Modbus 服务器/从站的值。如果选择 16/32 位整数显示格式以外的格式，则自动禁用缩放。

3.7. 实时图表

该图表可以实时绘制 12 个系列，每个系列最多 100000 个点。

3.8. 地址扫描

扫描地址范围以获取设备中所有有效地址的列表。

3.9. 打开一个新窗口

要打开另一个窗口，您有 3 个选项：

• 按 CTRL+N
• 在文件菜单中选择新建
• 按工具栏上的

4. 连接对话框

要打开连接对话框，您有 2 个选项：

• 按F3
• 从连接菜单中选择连接

4.1. 联系

有 5 种不同的连接类型：

1. 串行：
   通过串行线路的 Modbus。RS232 或 RS485。可以使用USB串行转换器。
2. Modbus TCP/IP：
   如果要与 MODBUS TCP/IP 网络通信，请选择 TCP/IP。在这种情况下，从站 ID 与 MODBUS TCP/IP 中使用的单元 ID 相同。
   端口号默认为 502。
   如果连接失败，请尝试在命令提示符下是否可以 ping 通您的设备。如果 ping 命令失败，则 Modbus 轮询也会失败。
3. Modbus UDP/IP：
   如果要与 MODBUS UDP/IP 网络通信，请选择 UDP/IP。这与 Modbus TCP/IP 相同，但使用无连接 UDP 协议。
4. TCP/IP 上的 Modbus RTU/ASCII：
   这是通过 TCP/IP 网络而不是串行线路发送的 RTU 或 ASCII 消息。
5. Modbus RTU/ASCII over UDP/IP：
   这是通过 UDP/IP 网络而不是串行线路发送的 RTU 或 ASCII 消息。

根据您的选择，一些其他设置将呈灰色。

4.2. 串口设置

使用这些参数来设置串行端口设置。仅当连接类型为“串行端口”时它们才可用。模式

使用此选项选择RTU或ASCII模式。默认 RTU。响应超时

指定 Modbus 轮询在放弃之前应等待从属设备响应的时间长度。默认值为 1000 毫秒。轮询之间的最小延迟

无论扫描速率如何，此设置都可确保传输下一个请求之前的最小延迟。该设置的分辨率约为15ms。在某些计算机上可以获得更好的分辨率，但并非全部。

用户波特率

如果默认波特率均无用，请指定自定义波特率。

4.3. 远程服务器

远程服务器设置仅在使用以太网连接时可用。IP地址

服务器 IP 地址。默认为本地主机 127.0.0.1港口

服务器端口号。默认502连接超时

用于建立连接的最长时间。默认 1000

4.4. 高级设置

即时战略切换

RTS 切换指定如果字节可用于传输，则 RTS 线将为高电平。发送所有缓冲字节后，RTS 线将为低电平。
如果您的 232/485 转换器没有自动方向开关，则可以使用它来切换方向。

数字SR

DSR 指定是否监视 DSR（数据集就绪）信号以进行输出流控制。如果该成员为 TRUE 并且 DSR 关闭，则输出将暂停，直到再次发送 DSR。CTS

CTS 指定是否监视 CTS（清除发送）信号以进行输出流量控制。如果启用此复选框并且关闭 CTS，则输出将暂停，直到再次发送 CTS。数字TR

DTR 指定每当端口打开时是否启用或禁用 DTR。消除回声

如果您的设备或 RS232/RS485 转换器回显刚刚发送的字符。

5. 读/写定义

使用此命令定义活动窗口要监视的数据。

要打开读/写定义对话框，您有 3 个选项：

• 按 F8
• 从设置菜单中选择“读/写定义”
• 按工具栏上的

5.1. 从机ID

范围 1 到 255。（MODBUS 协议规范规定为 247）。值 0 也可以直接与 MODBUS/TCP 或 MODBUS/UDP 设备通信。

5.2. 功能码

您可以选择 8 个功能代码中的 1 个。

5.2.1. 读取功能

读取函数返回的数据显示在网格窗口上。

• 01：读取线圈（0x）
• 02：读取离散输入 (1x)
• 03：读取保持寄存器（4x）
• 04：读取输入寄存器（3x）

5.2.2. 编写函数

写入函数写入网格窗口上显示的数据。

• 05：写入单个线圈（写入线圈状态）
• 06：写入单个寄存器（写入保持寄存器）
• 15：写入多个线圈（Writes to Coils）
• 16：写入多个寄存器（Writes to Holding registers）

5.3. 地址

Modbus协议中的地址很混乱！一些协议规范使用协议/消息地址，而其他协议规范则使用设备寻址。

5.3.1. 协议/消息地址

某些协议规范使用从 0 到 65535 计数的协议/消息地址以及功能代码。这也是新的 Modbus 规范所使用的内容。这是通过线路发送的消息中的地址。

Modbus Poll 使用从 0 到 65535 计数的协议/消息地址。

5.3.2. 设备地址

一些协议规范使用设备地址/寄存器。寄存器从 1 开始计数。第一个数字描述要使用的功能。这意味着设备地址 40101 由地址 100 标识。“4”表示保持寄存器和 4x 寄存器从 1 开始计数。更令人困惑的是：4x 表示功能代码 03，3x 表示功能代码 04！

5.3.3. 5 位与 6 位寻址

地址格式 4x 从 40001 计数到 49999。下一个地址不是50000。在过去，9999 个地址就足够了。有些情况下9999还不够。然后添加一个零。40101 变为 400101，依此类推。这称为 6 位寻址或扩展寻址。

这不是 Modbus 轮询的问题。410001 变成 10000。“4”被丢弃，剩下的 10001 减 1，因为我们从 0 而不是 1 开始计数。

5.3.4. 地址示例

这些示例展示了如果规范使用设备地址，如何设置 Modbus 轮询。

读取保持寄存器

您希望每 1000ms 从从机 ID 2 读取设备地址 40011 中的 20 个寄存器。从“4”我们知道这是功能03“读取保持寄存器”。

• 从机 ID = 2
• 功能 =“03 读取保持寄存器 (4x)”
• 地址 = 10（11 减 1）
• 数量 = 20
• 扫描率 = 1000

读取离散输入

您希望每 500ms 从从站 ID 5 读取地址 110201 的 1000 个线圈。从“1”我们知道这是功能02“读取离散输入”

• 从机 ID = 5
• 功能 =“02 读取离散输入 (1x)”
• 地址 = 10200 (10201 – 1)
• 数量 = 1000
• 扫描率 = 500

5.4. 扫描率

扫描速率可设置为 0 至 3600000ms。请注意，将扫描速率设置为低于事务时间是没有意义的。如果使用 9600 波特率的串行连接并请求 125 个寄存器，则事务时间大约为 8 + 2 + 250 + 2 = 262ms + 请求和响应之间的间隙（>3.5 个字符时间）。在这种情况下，将扫描速率设置为 100ms 是没有意义的，因为事务时间至少为 262ms + 从站延迟（间隙）+ 轮询之间的最短时间。（在连接对话框 F3 中设置）。

5.5. 读/写禁用

“读/写禁用”复选框可用于临时启用或禁用该窗口的通信。然后会显示文本（已禁用）以及 Tx 和错误计数器。

如果“读/写”被禁用，您可以使用“读/写一次”按钮或按 F6 发出单个请求。

“读/写一次”按钮

5.5.1. 出错时禁用

发生错误时禁用读/写。

5.6. 隐藏名称列

隐藏所有名称列。如果不使用它们，这可以方便地腾出更多空间。

5.7. 单元格中的地址

如果启用，地址也会显示在值单元格中，例如：2000 = 00000

5.8. PLC 地址（基地址 1）

此选项会将地址显示为设备地址。

5.9. 安然/丹尼尔·莫德

Enron 或 Enron/Daniels Modbus 是带有一些“供应商扩​​展”的标准 Modbus。这些扩展的确切影响取决于上下文，但最常见的 Modbus 命令按预期工作。有一些供应商定义的自定义函数可用 – 但很少有用户期望或使用它们。最大的影响与 32 位数据值的读/写方式有关。

Enron-Modbus 定义了两个特殊的 4x 保持寄存器范围：

• 假设 4×5001 到 4×5999 是 32 位长整数（每个寄存器 4 个字节）。
• 假设 4×7001 到 4×7999 是 32 位浮点（每个寄存器 4 个字节）。

在 Modbus 中处理 32 位值并不是 Enron-MB 所独有的。然而，Enron-MB 采取了有争议的步骤，即每个寄存器返回 4 字节，而不是 Modbus 规范中术语“保持寄存器”所暗示的 2 字节。这意味着 Enron-Modbus 中的寄存器 4×5001 和 4×5002 轮询会返回 8 字节或两个 32 位整数，而标准 Modbus 只会返回 4 字节或一个 32 位整数（被视为两个 16 位整数）。此外，Enron-MB 中的轮询寄存器 4×5010 返回第十个 32 位长整数，而标准 Modbus 会考虑此范围内第五个 32 位长整数的 1/2。

5.10. 行数

指定您喜欢的网格中的行数。

6. 实时图表

使用此命令可在图表中实时绘制最多 12 个数据系列。
实时图表速度很快，能够在收到新数据后尽快绘制新线。

要打开实时图表对话框，您有 2 个选项：

• 按 Alt + R
• 从显示菜单中选择“实时图表”

X 轴显示自图表启动以来的秒数。

当点到达图表末尾时，有 3 个选项：

• 结束时停止：图表停止。
• 结束时重新启动：图表重新开始。
• 继续：继续，直到达到最大点数或按下停止按钮。

6.1. 设置

默认情况下，所有 12 个系列都链接到左侧 Y 轴。如果要将系列链接到右 Y 轴，请选中“右 Y 轴”复选框。指定

• 颜色
• 右 Y 轴
• 标题。如果标题为空，则使用阅读窗口中的名称进行初始化
• 抵消

展示

• 文件名
• 地址

偏移对于在同一 Y 轴上对齐数据点很有用。例如，0 或 1 的数据点可以偏移，这样它们就不会绘制在彼此之上。

6.2. 变焦功能

如果您想查看更多详细信息，放大图表会很有用。缩放由鼠标左键控制。要缩放图表的特定部分，只需左键单击图表（这将是缩放矩形的左上角）并拖动到右下角。将出现一个矩形。一旦释放鼠标按钮，轴就会自动调整到您选择的区域。

如果您左键单击图表（例如开始缩放），但如果您移动到左上角，则使用缩放和平移功能完成的所有修改都将被取消（图表将处于原来的状态）在进行平移和缩放操作之前）。

6.3. 平移功能

要平移控件，请右键单击控件上的某处并移动鼠标。鼠标下方的点将跟随鼠标的移动。

6.4. 将数据链接到图表系列

除非将 Modbus 数据单元链接到 12 个系列之一，否则图表不知道要使用哪些数据。为此，选择一个值单元格，然后从菜单→显示中选择“链接到图表”。

6.5. 出口系列

将系列数据保存到磁盘或复制到剪贴板。将数据直接粘贴到 Excel 中以进行进一步处理。
尽管使用非逗号字段分隔符，但该文件仍具有 .csv 扩展名。

分隔符：选择分隔文本文件中的值的字符。复制/粘贴到 Excel 时使用制表符分隔符。此外还给出了一些附加信息。

• 点数
• 最大分值
• 最小分值
• 平均分值

7. 地址扫描

扫描地址范围以获取设备中所有有效地址的列表。地址被逐一读取，读取结果以列表形式显示。

7.1. 导出地址扫描

保存地址扫描数据到磁盘或复制到剪贴板。将数据直接粘贴到 Excel 中以进行进一步处理。
尽管使用非逗号字段分隔符，但该文件仍具有 .csv 扩展名。

分隔符：选择分隔文本文件中的值的字符。复制/粘贴到 Excel 时使用制表符分隔符。

8. 显示格式

标记要格式化的单元格。从显示菜单中选择 28 种显示格式之一。

8.1. 本机 Modbus 寄存器

16 位 Modbus 寄存器可以以 4 种不同的模式显示。

• 签
• 未签名
• 十六进制
• ASCII – 十六进制
• 二进制

8.2. 32 位有符号整数

它结合了 2 个 16 位 Modbus 寄存器。它可以以 4 种不同的字/字节顺序显示。

• 有符号整数 大尾数
• 有符号整数 小尾数
• 有符号整数大端字节交换
• 有符号整数小端字节交换例子字节顺序：AB CD（大端）
  十进制数 123456789 或十六进制数07 5B CD 15
  Modbus 消息中通过线路传输的顺序：07 5B CD 15

8.3. 32 位无符号整数

它结合了 2 个 16 位 Modbus 寄存器。它可以以 4 种不同的字/字节顺序显示。

• 无符号整数 大尾数
• 无符号整数 小尾数
• 无符号整数 Big-endian 字节交换
• 无符号整数小端字节交换例子字节顺序：AB CD（大端）
  十进制数 123456789 或十六进制数07 5B CD 15
  Modbus 消息中通过线路传输的顺序：07 5B CD 15

8.4. 64 位有符号整数

它结合了 4 个 16 位 Modbus 寄存器。它可以以 4 种不同的字/字节顺序显示。

• 有符号整数 大尾数
• 有符号整数 小尾数
• 有符号整数大端字节交换
• 有符号整数小端字节交换例子字节顺序：AB CD EF GH（大端）
  十进制数 -1,234,567,890,123,456,789 或十六进制数EE DD EF 0B 82 16 7E EB
  Modbus 消息中的线路顺序：EE DD EF 0B 82 16 7E EB

8.5。64 位无符号整数

它结合了 4 个 16 位 Modbus 寄存器。它可以以 4 种不同的字/字节顺序显示。

• 无符号整数 大尾数
• 无符号整数 小尾数
• 无符号整数 Big-endian 字节交换
• 无符号整数小端字节交换例子字节顺序：AB CD EF GH（大端）
  十进制数 1,234,567,890,123,456,789 或十六进制数11 22 10 F4
  7D E9 81 15 Modbus 消息中的线路顺序：11 22 10 F4 7D E9 81 15

8.6。32位浮点

它结合了 2 个 16 位 Modbus 寄存器。它可以以 4 种不同的字/字节顺序显示。

• 浮点大尾数
• 浮点数小尾数
• 浮点大端字节交换
• 浮点小端字节交换例子字节顺序：AB CD（大端）
  浮点数 123456.00 或十六进制47 F1 20 00
  Modbus 消息中的线路顺序：47 F1 20 00

8.7. 64位双

它结合了 4 个 16 位 Modbus 寄存器。它可以以 4 种不同的字/字节顺序显示。

• 双大尾数
• 双小端
• 双大端字节交换
• 双小端字节交换例子字节顺序：AB CD EF GH（大端）
  浮点数 123456789.00 或十六进制41 9D 6F 34 54 00 00 00
  Modbus 消息中的线路顺序：41 9D 6F 34 54 00 00 00

9. 保存/打开工作区

如果您打开许多相关的 Modbus 窗口，可以方便地在一个工作区中保存所有打开和排列的 Modbus 窗口的当前布局的快照。

工作区 (*mbw) 是一个包含所有打开窗口的显示信息和文件名的文件。不是实际内容。为此，请转到“文件”→“保存工作区”。

连接和图表设置存储在工作区文件中。

当您打开工作区文件时，Modbus 轮询会打开所有 Modbus 窗口并以您保存的布局显示它们。

10.导出为csv

将名称和值导出到逗号、分号或制表符分隔值文件。从文件对话框中选择

• 逗号分隔值文件 (*.csv)
  “Temperature”,”19.7″
• 分号分隔值文件 (*.csv)
  “Temperature”;”19.7″
• 制表符分隔值文件 (*.txt)
  温度 19.7

根据您的系统，使用逗号或句点来分隔小数。

11. 导出到Modbus Slave

将名称、值和格式导出到 Modbus 从站文件。*.mbs

需要 Modbus Slave 版本 7.4.0 或更高版本才能打开该文件。

12. 测试中心

此测试对话框的目的是帮助 MODBUS 从站设备开发人员使用自己组成的任何字符串来测试设备。
列表框显示发送的数据以及接收的数据。
下拉列表框中可以有多个测试字符串。输入字符串后，按“添加到列表”按钮，该字符串就会添加到列表中。
当按下“发送”按钮时，将发送所选字符串。打开列表

从文件中恢复测试字符串。保存列表

将测试字符串存储到文件中。清除

清除测试列表。添加到列表

将当前测试字符串添加到列表中。添加支票

将 CRC 或 LRC 添加到输入字符串的末尾。

使用测试中心时，您可能希望禁用其他窗口的通信。选中“读/写定义”对话框中的“读/写禁用”复选框。设置→读/写定义。

12.1。ASCII 示例

组合框中的字符串：3A 30 31 30 33 30 30 30 30 30 30 30 41

添加LRC时传输的字符串3A 30 31 30 33 30 30 30 30 30 30 30 41 46 32 0D 0A

还添加了 CR LF 对。

12.2. TCP/IP 示例

读取 10 个保持寄存器。00 00 00 00 00 06 01 03 00 00 00 0A

前 6 个字节是 TCP/IP 标头。

12.3。测试中心字符串文件

使用记事本或类似的文本编辑器，您可以准备要在测试中使用的字符串。
文件中的第一行必须是字符串“TestCenter”。这就是 Modbus Poll 知道文件格式正确的方式。按“打开列表”打开准备好的文本文件。

12.3.1. 字符串列表的内容

测试中心 3A 30 31 30 33 30 30 30 30 30 30 30 41 3A 30 32 30 33 30 30 30 30 30 30 30 41 3A 30 33 30 33 30 30 30 30 30 30 30 41

12.4。复制

使用复制按钮将选定的 Tx/Rx 字符串复制到剪贴板。
SHIFT 和 CTRL 键可与鼠标一起使用来选择和取消选择字符串、选择字符串组以及选择不相邻的字符串。

13.Modbus数据记录

您可以将数据记录到文本文件或直接记录到 Microsoft Excel。

13.1. 文本文件

从设置菜单中选择“日志”或使用快捷键：Alt+L

每个 Modbus 窗口都会记录到其单独的文本文件中。

当您想要停止数据记录时，请在设置菜单上选择注销命令。

13.1.1. 记录率

每读

为所有 Modbus 请求编写日志行。将频率记录为扫描速率。选择

指定日志速率（以秒为单位）。与扫描速率无关。

13.1.2. 分隔符

作为分隔符，您可以使用以下选项之一：固定宽度

意味着值按列组织。逗号

值以逗号分隔。标签

值由制表符分隔。

13.1.3。仅当数据发生更改时才记录

指定仅当自上次日志以来有任何数据更改时才写入新的日志行。

13.1.4。记录错误

指定记录超时等错误。

13.1.5。记录日期

指定将当前日期添加到日志时间中。

13.1.6。使用“T”作为分隔符

指定时间和日期由 ISO 8601 中指定的字母“T”分隔。

13.1.7。记录毫秒

指定将毫秒添加到日志时间中。

13.1.8。日志地址

指定将 Modbus 地址添加到日志中。

13.1.9。按下“确定”后开始记录

指定按下确定按钮时开始记录。否则，日志设置仅在保存 *mbp 文件时存储。

13.1.10。*mbp 打开时启动日志

指定打开 *.mbp 文件时自动启动日志记录。

13.1.11。立即冲入档案

这确保日志行不会被缓存到文件系统中，而是立即以物理方式写入。

13.1.12。附加

指定将日志附加到所选文件。否则会创建一个新文件。

13.1.13。午夜新日志文件

关闭当前日志文件并在午夜启动新文件。时间戳会添加到您的文件名中。

13.1.14。标头信息

• 插入标题：信息插入到日志文件的顶部。
  • 顶行中的名称单元格：插入名称。
  • 投票定义：插入 ID、功能等。
  • 名称：插入日志的名称。

固定宽度的文本文件示例：22:28:13 <40001> 17395 0 0 0 0 0 0 0 0 22:28:14 <40001> 17396 1 0 0 0 0 0 0 0 22:28:15 <40001> 17394 1 0 0 2 55 0 0 0 22:28:16 <40001> 13350 1 0 0 4 0 0 0 0

您可以导入 Excel 电子表格中的数据。

13.2. 微软Excel

此功能需要安装 Microsoft Excel。Excel 2003 日志限制为 65535 条日志，因为这是 Excel 工作表中的最大行数。Excel 2007 或更高版本仅限于 1,048,576 行。每个 Modbus 窗口都会记录到其单独的 Excel 工作表中。

从设置菜单中选择 Excel Log 或使用快捷键：Alt+X

记录时请勿触摸 Excel 工作表，因为这会中断记录。

13.2.1. 记录率

• 每次读取：为所有 Modbus 请求写入日志行。将频率记录为扫描速率。
• 选择：指定日志速率（以秒为单位）。日志与扫描速率无关。
  备注：如果扫描速率为 10000ms，则设置 1 秒的记录速率是没有意义的，因为仅当新数据准备好时才会记录数据。
• 停止时间：指定日志行数。请注意，Excel 2003 限制为 65,536 行，Excel 2007 限制为 1,048,576 行。

13.2.2. 标头信息

• 插入标题：信息插入到 Excel 工作表的最上面 3 行。
  • 顶行中的单元格名称：在第 3 行中插入名称。
  • 投票定义：在第 2 行插入 ID、功能等。
  • 名称：在第 1 行插入日志名称。

带有标题信息的 Excel 日志。

14.通讯流量

选择菜单“显示”→“通讯”以显示串行线路或以太网电缆上的流量。使用停止按钮暂时停止更新以进行检查。

使用复制按钮将所选行复制到剪贴板。

15.OLE/自动化

自动化（以前称为 OLE 自动化）使一个应用程序可以操作另一应用程序中实现的对象。

自动化客户端是一个可以操作属于另一个应用程序的公开对象的应用程序。这也称为自动化控制器。

自动化服务器是向其他应用程序公开可编程对象的应用程序。Modbus Poll是一个自动化服务器。

这意味着您可以使用任何支持VBA（Visual Basic for Applications）的程序（例如Visual Basic、Excel等）根据您的具体要求解释和显示modbus数据。

15.1. Excel 示例

当您想要编写宏时，您应该显示“开发人员”选项卡或在开发人员模式下运行。

15.1.1. Excel 2007

1. 单击 Microsoft Office 按钮，然后单击 Excel 选项。
2. 单击“流行”，然后选中“在功能区中显示开发人员选项卡”复选框。
   请注意，功能区是 Microsoft Fluent 用户界面的一部分。

15.1.2. Excel 2010、2016

1. 单击文件选项卡。
2. 单击选项。Excel 选项窗口将打开。
3. 在左侧窗格中单击“自定义功能区”。
4. 在右侧窗格的“主选项卡”下，选中“开发人员”复选框。
5. 单击“确定”。“开发人员”选项卡现在应该显示在功能区中（最右侧的选项卡）。

15.1.3。Excel 示例代码

此示例打开两个窗口。一个读取寄存器，另一个读取线圈。
Modbus 轮询是隐藏的，但您可以通过取消注释“ShowWindow”行来显示它。这将显示其中一个窗口。

Modbus 轮询安装中还包含一个示例。
开始 → 所有程序 → Modbus 轮询 → Excel 示例Excel VBA 示例

Public doc1 As Object
Public doc2 As Object
Public app As Object
Dim res As Integer
Dim n As Integer

Private Sub StartModbusPoll_Click()
   Set app = CreateObject("Mbpoll.Application")
   Set doc1 = CreateObject("Mbpoll.Document")
   Set doc2 = CreateObject("Mbpoll.Document")
' Read 10 Holding Registers every 1000ms
   res = doc1.ReadHoldingRegisters(1, 0, 10, 1000)
' Read 10 Coil Status every 1000ms
   res = doc2.ReadCoils(1, 0, 10, 1000)
' doc1.ShowWindow()
   app.Connection = 1 ' Modbus TCP/IP
   app.IPAddress = "127.0.0.1" ' local host
   app.ServerPort = 502
   app.ConnectTimeout = 1000
   res = app.OpenConnection()
End Sub

Private Sub Read_Click()
   Cells(5, 7) = doc1.ReadResult() 'Show results for the requests
   Cells(6, 7) = doc2.ReadResult()

   For n = 0 To 9
      Cells(5 + n, 2) = doc1.SRegisters(n)
   Next n

   For n = 0 To 9
      Cells(18 + n, 2) = doc2.Coils(n)
   Next n
End Sub

15.2. Python示例

此 Python 示例打开一个窗口并设置所有可能的数据格式。Python 示例

import win32com.client as win32

SIGNED = 0
UNSIGNED = 1
HEX = 2
BINARY = 3
FLOAT_LE_BS = 4
FLOAT_BE = 5
DOUBLE_LE_BS = 6
DOUBLE_BE = 7
S32_LE_BS = 8
S32_BE = 9
FLOAT_LE = 10
FLOAT_BE_BS = 11
DOUBLE_LE = 12
DOUBLE_BE_BS = 13
S32_LE = 14
S32_BE_BS = 15

U32_BE = 17
U32_LE_BS = 18
U32_BE_BS = 19
U32_LE = 20

S64_BE = 21
S64_LE_BS = 22
S64_BE_BS = 23
S64_LE = 24

U64_BE = 25
U64_LE_BS = 26
U64_BE_BS = 27
U64_LE = 28

#Endianness
BE = 0
LE = 3
BE_BS = 2
LE_BS = 1

App = win32.Dispatch('Mbpoll.Application')

App.Connection = 1
App.IPAddress = "127.0.0.1"

App.ServerPort = 502
App.OpenConnection

#Create a Modbus display window called Win1
Win1 = win32.Dispatch("Mbpoll.Document")

# Read 100 holding registers from slave ID 1, address 0 (40001) every 1000ms
Win1.ReadHoldingRegisters(1, 0, 100, 1000)
# Show the Modbus window
Win1.ShowWindow()
# Show 20 rows
Win1.Rows(1)

# Disable refresh for speed
Win1.EnableRefresh = False

# Set all different formats
# This sets how the value is displayed
Win1.SetFormat(0, SIGNED)
Win1.SetFormat(1, UNSIGNED)
Win1.SetFormat(2, HEX)
Win1.SetFormat(3, BINARY)

Win1.SetFormat(4, S32_BE)
Win1.SetFormat(6, S32_LE)
Win1.SetFormat(8, S32_BE_BS)
Win1.SetFormat(10, S32_LE_BS)

Win1.SetFormat(12, U32_BE)
Win1.SetFormat(14, U32_LE)
Win1.SetFormat(16, U32_BE_BS)
Win1.SetFormat(18, U32_LE_BS)

Win1.SetFormat(20, S64_BE)
Win1.SetFormat(24, S64_LE)
Win1.SetFormat(28, S64_BE_BS)
Win1.SetFormat(32, S64_LE_BS)

Win1.SetFormat(40, U64_BE)
Win1.SetFormat(44, U64_LE)
Win1.SetFormat(48, U64_BE_BS)
Win1.SetFormat(52, U64_LE_BS)

Win1.SetFormat(60, FLOAT_BE)
Win1.SetFormat(62, FLOAT_LE)
Win1.SetFormat(64, FLOAT_BE_BS)
Win1.SetFormat(66, FLOAT_LE_BS)

Win1.SetFormat(80, DOUBLE_BE)
Win1.SetFormat(84, DOUBLE_LE)
Win1.SetFormat(88, DOUBLE_BE_BS)
Win1.SetFormat(92, DOUBLE_LE_BS)

# Set all Names to used format
Win1.SetName(0, "SIGNED")
Win1.SetName(1, "UNSIGNED")
Win1.SetName(2, "HEX")
Win1.SetName(3, "BINARY")

Win1.SetName(4, "S32_BE")
Win1.SetName(6, "S32_LE")
Win1.SetName(8, "S32_BE_BS")
Win1.SetName(10, "S32_LE_BS")

Win1.SetName(12, "U32_BE")
Win1.SetName(14, "U32_LE")
Win1.SetName(16, "U32_BE_BS")
Win1.SetName(18, "U32_LE_BS")

Win1.SetName(20, "S64_BE")
Win1.SetName(24, "S64_LE")
Win1.SetName(28, "S64_BE_BS")
Win1.SetName(32, "S64_LE_BS")

Win1.SetName(40, "U64_BE")
Win1.SetName(44, "U64_LE")
Win1.SetName(48, "U64_BE_BS")
Win1.SetName(52, "U64_LE_BS")

Win1.SetName(60, "FLOAT_BE")
Win1.SetName(62, "FLOAT_LE")
Win1.SetName(64, "FLOAT_BE_BS")
Win1.SetName(66, "FLOAT_LE_BS")

Win1.SetName(80, "DOUBLE_BE")
Win1.SetName(84, "DOUBLE_LE")
Win1.SetName(88, "DOUBLE_BE_BS")
Win1.SetName(92, "DOUBLE_LE_BS")

# Refresh
Win1.EnableRefresh = True

Win1.ResizeAllColumns ()
Win1.ResizeWindow()

result = Win1.Save("C:\Users\UserName\Desktop\testfile.mbp")
print (result)

print (Win1.GetName(1))

_ = input("Press ENTER to quit:")

15.3。连接功能/属性

以下属性和功能与您在连接对话框 (F3) 中的设置相同。

15.3.1。联系

连接选择所需的连接。可以选择串行端口或以太网连接之一。

属性连接为整数有效值

0 = 串行端口
1 = Modbus TCP/IP
2 = Modbus UDP/IP
3 = Modbus ASCII/RTU over TCP/IP
4 = Modbus ASCII/RTU over UDP/IP
例子

Connection = 0

15.3.2. 波特率

仅适用于连接 = 0

属性BaudRate as Long有效值

300
600
1200
2400
4800
9600（默认）
14400
19200
38400
56000
57600
115200
128000
153600
230400
256000
460800
921600例子

BaudRate = 9600

15.3.3。数据位

仅适用于连接 = 0

属性DataBits作为整数有效值

7
8（默认）
例子

DataBits = 8

15.3.4。平价

仅适用于连接 = 0

财产平价作为整数有效值

0 = 无
1 = 奇数
2 = 偶数（默认）
例子

Parity = 2

15.3.5。停止位

仅适用于连接 = 0

属性StopBits作为整数有效值

1（默认）
2
例子

StopBits = 1

15.3.6。串行端口

仅适用于连接 = 0

属性SerialPort作为整数有效值

1…255

默认值 = 1例子

SerialPort = 1

15.3.7。模式

仅适用于连接 = 0

属性模式为整数有效值

0 = RTU 模式
1 = ASCII 模式
例子

Mode = 1

15.3.8。删除回声

仅适用于 Connection = 0
如果您的设备或 RS232/RS485 转换器回显刚刚发送的字符。

属性RemoveEcho as Integer有效值

0（默认）
1（消除回声）
例子

RemoveEcho = 1

15.3.9。响应超时

ResponseTimeout 指定 Modbus 轮询在放弃之前应等待从属设备响应的时间长度（以毫秒为单位）。

属性ResponseTimeout作为整数有效值

50…100000

默认值 = 1000例子

ResponseTimeout = 1000

15.3.10。轮询之间的延迟

属性DelayBetweenPolls作为 Integer有效值

0…1000

默认值 = 20例子

DelayBetweenPolls = 20

15.3.11. 服务器端口

仅适用于连接 = 1…4

属性ServerPort为 Long有效值

0…65535

默认值 = 502例子

ServerPort = 502

15.3.12. 连接超时

ConnectTimeout 指定 Modbus 轮询应等待 TCP/IP 连接成功的时间长度。

仅适用于连接 = 1…4

属性ConnectTimeout作为 Integer有效值

100…30000 毫秒

默认值 = 1000 毫秒例子

ConnectTimeout = 1000

15.3.13。IP版本

仅适用于连接 = 1…4

属性IPVersion作为整数有效值

4 = IP 版本 4（默认）
6 = IP 版本 6
例子

IPVersion = 4

15.3.14。开放连接

打开使用“连接”属性选择的连接。

函数OpenConnection () 作为整数参数

该函数没有参数。返回值

对于错误3-5：请检查您是否安装了最新的串口驱动。

如何打开 Modbus TCP/IP 连接的 Excel 示例

Public app As Object
Dim res As Integer
' Create an object to Modbus Poll
Set app = CreateObject("Mbpoll.Application")
app.Connection = 1 ' Select Modbus TCP/IP
app.IPVersion = 4
app.IPAddress = "192.168.1.27"
app.ServerPort = 502
app.ConnectTimeout = 1000
app.ResponseTimeout = 1000
res = app.OpenConnection()

Python 示例如何设置串行连接

import win32com.client as win32

App = win32.Dispatch('Mbpoll.Application')

App.Connection = 0            # Serial connection
App.SerialPort = 3            # Com port 3
App.BaudRate = 9600           # 9600 baud
App.Parity = 0                # None parity
App.Mode = 0                  # RTU mode
App.ResponseTimeout = 1000    # Wait 1000ms until give up
App.DelayBetweenPolls = 20    # Ensure minimum 20 ms gap until next request
App.OpenConnection

#Create a Modbus display window called Win1
Win1 = win32.Dispatch("Mbpoll.Document")

# Read 10 holding registers from slave ID 1, address 0 (40001) every 1000ms
Win1.ReadHoldingRegisters(1, 0, 10, 1000)
# Show the Modbus window
Win1.ShowWindow()
# Show 10 rows
Win1.Rows(0)

# Disable refresh for speed
Win1.EnableRefresh = False

# Set the name of the registers
Win1.SetName(0, "Register 0")

# Set the value to write
Win1.EnableRefresh = True

Win1.ResizeAllColumns ()
Win1.ResizeWindow()

_ = input("Press ENTER to quit:")

15.3.15。关闭连接

函数CloseConnection () As Integer参数

该函数没有参数。返回值

如果成功则为零。如果失败则非零值。

15.3.16。显示通讯交通

显示通信流量窗口。

函数ShowCommunicationTraffic ()参数

该函数没有参数。返回值

没有任何

15.3.17。关闭通讯交通

关闭通信流量窗口（如果显示）。

函数CloseCommunicationTraffic ()参数

该函数没有参数。返回值

没有任何

15.4。读取函数

以下功能与您在读/写定义对话框 (F8) 中设置的功能相同。读取功能与 Modbus 轮询文档关联。（有数据的窗口）例子

' First a Modbus Poll document is needed.
Public doc As Object

Set doc = CreateObject("Mbpoll.Document")
res = doc.ReadCoils(1, 0, 100, 1000) ' Read 100 coils every 1000ms

15.4.1. 读取线圈

Modbus功能码01

Function ReadCoils (SlaveID As Integer, Address As Long, Quantity As Integer, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（基址 0）
数量：数据数量。1 至 2000
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假

15.4.2. 读取离散输入

Modbus功能代码02

Function ReadDiscreteInputs (SlaveID As Integer, Address As Long, Quantity As Integer, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（基址 0）
数量：数据数量。1 至 2000
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假

15.4.3。读取持有寄存器

Modbus功能代码03

Function ReadHoldingRegisters (SlaveID As Integer, Address As Long, Quantity As Integer, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（基址 0）
数量：数据数量。1 至 125
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假

15.4.4。读输入寄存器

Modbus 功能代码 04

Function ReadInputRegisters (SlaveID As Integer, Address As Long, Quantity As Integer, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（基址 0）
数量：数据数量。1 至 125
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假

15.5。自动写入功能

写入函数将存储在由属性填充的数组中的值写入。下面的 Write 函数不创建数据窗口。要创建数据窗口，请使用 Win 函数，例如WriteMultipleRegistersWin。

15.5.1。写单线圈

Modbus 功能代码 05。
写入存储在写入数组中的第一个线圈。

Function WriteSingleCoil (SlaveID As Integer, Address As Long) As Integer参数

SlaveID：从机地址 0 到 255
地址：数据地址（基址 0）返回值

如果写入数组已准备好并且数据已发送，则为 True。如果数组为空或参数错误，则返回 False。
控制应用程序负责通过读回写入的值来验证写入操作。

15.5.2。写单个寄存器

Modbus 功能代码 06。
写入写入数组中存储的第一个寄存器。

Function WriteSingleRegister (SlaveID As Integer, Address As Long) As Integer参数

SlaveID：从机地址 0 到 255
地址：数据地址（基址 0）返回值

如果写入数组已准备好并且数据已发送，则为 True。如果数组为空或参数错误，则返回 False。
控制应用程序负责通过读回写入的值来验证写入操作。

15.5.3。写入多个线圈

Modbus 功能代码 15.
写入存储在写入数组中的线圈。

Function WriteMultipleCoils (SlaveID As Integer, Address As Long, Quantity As Integer) As Integer返回值

如果写入数组已准备好并且数据已发送，则为 True。如果数组为空或参数错误，则返回 False。
控制应用程序负责通过读回写入的值来验证写入操作。参数

SlaveID：从机地址 0 到 255
地址：数据地址（基址 0）数量数据的数量
。1 至 1968 年

15.5.4。写入多个寄存器

Modbus 功能代码 16.
写入写入数组中存储的寄存器。

Function WriteMultipleRegisters (SlaveID As Integer, Address As Long, Quantity As Integer) As Integer参数

SlaveID：从机地址 0 到 255
地址：数据地址（基址 0）
数量：数据数量。1 至 123返回值

如果写入数组已准备好并且数据已发送，则为 True。如果数组为空或参数错误，则返回 False。
控制应用程序负责通过读回写入的值来验证写入操作。

15.5.5。Python示例

Python 示例如何创建一个从地址 0 (40001) 读取 10 个寄存器，然后写入 5 个寄存器的窗口。Python示例

import sys
import time
import win32com.client as win32

App = win32.Dispatch('Mbpoll.Application')

App.Connection = 1            # TCP/IP connection
App.IPAddress = "127.0.0.1"

App.ResponseTimeout = 1000    # Wait 1000ms until give up
App.DelayBetweenPolls = 20    # Ensure minimum 20 ms gap until next request
App.ConnectTimeout = 500      # Wait 500ms until give up

App.ServerPort = 502
result = App.OpenConnection

if result != 0:
   print("Connection failed. Error: ", result)
   sys.exit()

#Create a Modbus display window called Win1
Win1 = win32.Dispatch("Mbpoll.Document")

# Read 10 holding registers from slave ID 1, address 0 (40001) every 1000ms
Win1.ReadHoldingRegisters(1, 0, 10, 1000)
# Show the Modbus window
Win1.ShowWindow()
# Show 10 rows
Win1.Rows(0)
# Resize the window to fit to the grid
Win1.ResizeWindow()

time.sleep(1.0) # Wait until read is done

if Win1.ReadResult == 0:    # Check read result
   print("Modbus register 0 (40001) = ", Win1.SRegisters(0))
else:
   print("Read failed error: = ", Win1.ReadResult)

print ("Tx count = %d, Rx count = %d" % (Win1.GetTxCount, Win1.GetRxCount))

# Prepare the internal array in Modbus Poll with data to write
Win1.SRegisters(0, 1)   # Note that parameter 1 is not a
Win1.SRegisters(1, 10)  # Modbus address but an index to the array
Win1.SRegisters(2, 100)
Win1.SRegisters(3, 1000)
Win1.SRegisters(4, 10000)
# Write the registers. This function do not create a window in Modbus Poll
# Use the function <<WriteMultipleRegistersWin>> to create a data window
Win1.WriteMultipleRegisters (1, 0, 5)

_ = input("Wait for write Press ENTER:")

if Win1.WriteResult == 0:    # Check write result
   print("Modbus write success")
else:
   print("Write failed error: = ", WriteResult)

_ = input("Press ENTER to quit:")

15.6。多种功能

各种功能与 Modbus 轮询文档相关联。（有数据的窗口）

15.6.1。橱窗展示

默认情况下，Modbus 文档窗口是隐藏的。ShowWindow 功能使 Modbus Poll 可见并显示带有数据内容的文档。

函数显示窗口()参数

该函数没有参数。返回值

没有任何

15.6.2。获取发送计数

获取请求数。

函数GetTxCount () 只要参数

该函数没有参数。返回值

请求的数量。

15.6.3。获取接收计数

获取响应数。

函数GetRxCount () 只要参数

该函数没有参数。返回值

响应数。

15.6.4。获取名称

获取值的名称。

函数GetName（索引为整数）作为字符串参数

索引：索引0对应第一个Modbus地址。返回值

名字。

15.6.5。设置名称

更改值的名称。函数SetName（索引为整数，名称为字符串）参数

索引：索引0对应第一个Modbus地址。
名称：值单元格的名称。返回值

没有任何

15.6.6。全部格式化

使用所选格式设置所有值单元格的格式。

函数FormatAll（格式化为整数）参数

格式：值单元格的格式。返回值

没有任何

15.6.7。获取格式

获取Modbus值的显示格式。

函数GetFormat（索引为整数）作为整数参数

索引：索引0对应第一个Modbus地址。
返回值

15.6.8。设置格式

更改 Modbus 值的显示格式。请参阅上面的格式值。

函数SetFormat（索引为整数，格式为整数）参数

索引：索引0对应第一个Modbus地址。
格式：值单元格的格式。返回值

没有任何

15.6.9。调整窗口大小

调整打开的窗口的大小以适合网格。

函数调整窗口大小()参数

该函数没有参数。返回值

没有任何

15.6.10。调整所有列的大小

调整所有列的大小以适合单元格内的值。

函数调整所有列的大小（）参数

该函数没有参数。返回值

没有任何

15.6.11。行数

指定网格中的行数。

函数行（NumberRows）参数

NumberRows：网格中的行数。

返回值

没有任何

15.6.12。读取结果

使用此属性可检查通过 Read 建立的通信是否运行成功。

属性将结果读取为整数参数

该函数没有参数。返回值

15.6.13。写入结果

使用此函数检查写入是否成功。
该值一直为 DATA_UNINITIALIZED，直到从站的结果可用为止。请参阅ReadResult以获取可能值的列表。

属性WriteResult As Integer返回值

以整数形式返回写入结果。

15.6.14。节省

保存当前窗口。函数Save (PathName As String) As Boolean参数

PathName：文件应保存到的完全限定路径。返回值

布尔值例子

' First a Modbus Poll document is needed.
Public doc As Object

Set doc = CreateObject("Mbpoll.Document")
res = doc.ReadCoils(1, 0, 100, 1000) ' Read 100 coils every 1000ms
res = doc.Save("C:\Users\UserName\Desktop\testfile.mbp")

15.7。自动化数据属性

以下属性用于在 Modbus Poll 中设置或获取内部写入/读取数组中的值。使用的索引不是 Modbus 地址。无论使用什么地址，索引始终从 0 开始计数。数据属性与 Modbus 轮询文档关联。（有数据的窗口）

每个数据属性有 2 个版本：

• 没有后缀的一种，例如SRegisters，用于从内部写/读数组设置或获取值。
• 一种以 Win 作为后缀，例如SRegistersWin，用于直接从数据窗口设置或获取值。当数据窗口用于写入函数（例如WriteMultipleRegistersWin ）时，将使用此功能。

示例1：

' doc is assumed created first. See Excel example.
' Writes 1 to index 0 in the data array used for the Write function later
doc.SRegisters(0) = 1
doc.SRegisters(1) = 10
doc.SRegisters(2) = 1234
' Write 3 registers stored in Modbus Poll internal array
' to Modbus address 100 (40101)
' A window is not created
res = doc.WriteMultipleRegisters(1, 100, 3)
' The above example do not create a data window but just make a single Modbus write.

使用浮点值的示例 2：
写入 3 个浮点值。

' doc is assumed created first. See Excel example.
doc.Floats(0) = 1.3
doc.Floats(2) = 10.5
doc.Floats(4) = 1234.12
' Write the 6 register stored in Modbus Poll
res = doc. WriteMultipleRegisters(1, 0, 6)
' 6 Registers are written as a floating point value is 32 bit wide.

示例 3：
创建一个写入 3 个寄存器的窗口。

' doc is assumed created first. See Excel example.
' A window is created that writes the content every 1000ms
res = doc.WriteMultipleRegistersWin(1, 100, 3, 1000)
' Writes 1 to the first cell in the data window
doc.SRegistersWin(0) = 1
doc.SRegistersWin(1) = 10
doc.SRegistersWin(2) = 1234
' Now the 3 registers are written to slave id 1 address 100 every 1000ms

15.7.1。线圈、线圈Win

属性线圈（索引为整数）为整数描述

在写入数组结构中设置一个线圈或从读取数组中返回一个线圈。句法

线圈（索引）[=新值]

15.7.2。SRegisters、SRegistersWin

属性SRegisters（索引为整数）为整数描述

在写入数组结构中设置寄存器或从读取数组中返回寄存器。句法

SRegisters（索引）[=新值]

15.7.3。URegisters、URegistersWin

属性URegisters（索引为整数）只要描述

在写入数组结构中设置寄存器或从读取数组中返回寄存器。句法

URegisters（索引）[=新值]

15.7.4。Ints_32、Ints_32Win

属性Ints_32（索引为整数）为 Double描述

在写入数组结构中设置一个 32 位整数，或从读取数组中返回一个整数。句法

Ints_32（索引）[=新值]

15.7.5。UInts_32、UInts_32Win

属性UInts_32（索引为整数）为 Double描述

在写入数组结构中设置一个 32 位无符号整数，或从读取数组中返回一个无符号整数。句法

UInts_32（索引）[=新值]

15.7.6。Ints_64、Ints_64Win

属性Ints_64（索引为整数）为 Double描述

在写入数组结构中设置一个 64 位整数，或从读取数组中返回一个整数。句法

Ints_64（索引）[=新值]

15.7.7。UInts_64、UInts_64Win

属性UInts_64（索引为整数）为 Double描述

在写入数组结构中设置一个 64 位无符号整数，或从读取数组中返回一个无符号整数。句法

UInts_64（索引）[=新值]

15.7.8。花车，花车赢

属性浮动（索引为整数）为单个描述

在写入数组结构中设置一个浮点数或从读取数组中返回一个浮点数。句法

浮点数（索引）[=新值]

15.7.9。双打、双打获胜

属性双精度（索引为整数）为双精度描述

在写入数组结构中设置双精度值或从读取数组中返回双精度值。句法

双打（索引）[=新值]

15.7.10。字节顺序

属性ByteOrder作为整数描述

设置 Ints_32、UInts_32、Ints_64、UInts_64、Floats 和 Doubles 属性使用的字节顺序。
Win 版本不使用此属性ByteOrder。

Ints_32 示例：
字节顺序：Big-endian
十进制数 123456789 或十六进制数 07 5B CD 15
Modbus 消息中通过线路传输的顺序：07 5B CD 15句法

字节顺序[=新值]

15.8。编写函数（创建数据窗口）

以下功能与您在读/写定义对话框 (F8) 中设置的功能相同。
该函数创建一个数据窗口，并根据扫描速率写入数据窗口中的数据内容。

15.8.1。写单线圈赢

Modbus 功能代码 05。

Function WriteSingleCoilWin (SlaveID As Integer, Address As Long, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（Base 0）
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假

15.8.2。写单寄存器Win

Modbus 功能代码 06。

Function WriteSingleRegisterWin (SlaveID As Integer, Address As Long, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（Base 0）
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假Python 示例如何打开一个窗口并每 1000 毫秒写入一个寄存器

import win32com.client as win32

SIGNED = 0

App = win32.Dispatch('Mbpoll.Application')

App.Connection = 1
App.IPAddress = "127.0.0.1"

App.ServerPort = 502
App.OpenConnection

#Create a Modbus display window called Win1
Win1 = win32.Dispatch("Mbpoll.Document")

# Write 1 holding registers to slave ID 1, address 0 (40001) every 1000 ms
Win1.WriteSingleRegisterWin(1, 0, 1000)
# Show the Modbus window
Win1.ShowWindow()

# Fit rows to quantity
Win1.Rows(4)

# Disable refresh for speed
Win1.EnableRefresh = False

# This sets how the value is displayed
Win1.SetFormat(0, SIGNED)

# Set the Name of the register
Win1.SetName(0, "Setting")

# Set the value to write
Win1.SRegistersWin(0, 100)
Win1.EnableRefresh = True

Win1.ResizeAllColumns ()
Win1.ResizeWindow()

_ = input("Press ENTER to quit:")

15.8.3。写入多个线圈Win

Modbus 功能代码 15。

Function WriteMultipleCoilsWin (SlaveID As Integer, Address As Long, Quantity As Integer, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（基址 0）
数量：数据数量。1 至 1968
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假

15.8.4。写入多个寄存器Win

Modbus 功能代码 16。

Function WriteMultipleRegistersWin (SlaveID As Integer, Address As Long, Quantity As Integer, ScanRate As Long) As Integer参数

SlaveID：从机地址 1 至 255
地址：数据地址（基址 0）
数量：数据数量。1 至 123
扫描速率： 0 至 3600000ms返回值

如果成功则为真。如果没有成功则为假

16. 异常和错误消息

Modbus 异常和错误消息以红色文本显示在每个窗口的第二行^。

16.1. Modbus 异常代码

Modbus 异常是从从设备返回的错误。

16.2. Modbus 轮询错误消息