Modbus Poll 中文版用户手册及软件下载

Modbus Poll简介

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

其中包括：

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

Modbus Poll 的系统要求

硬件要求

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

支持从 Windows 7 到 Windows 11 的所有 Windows 版本。

Modbus Poll功能

连接

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

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

支持的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） 读取设备标识

数据记录

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

显示格式

每个单元格都可以单独设置格式。

其他功能

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

Modbus Poll概述

Modbus Poll 使用多窗口界面。这意味着可以打开几个窗口。 每个都同时具有来自不同从站设备的不同数据内容。

随时随地提供帮助

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

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

命名单元格

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

值单元格

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

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

更改字体

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

• 选择要更改的单元格，然后单击鼠标右键。
• 选择要更改的单元格，然后选择 Menu→Display→Font。

条件颜色

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

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

7种比较运算符

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

颜色示例

如果单元格值大于 0，则为绿色，如果小于 0，则为红色。

缩放

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

（X1，Y1） 和 （X2，Y2）

穿过两点 （X1，Y1） 和 （X2，Y2） 的线

线方程

精度

小数点后的位数。

使

必须启用才能从 Modbus 服务器/从站缩放值。如果出现其他情况，则自动禁用缩放 选择 16/32 位整数显示格式。

实时图表

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

地址扫描

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

打开一个新窗口

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

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

连接对话框

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

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

连接（Connection）

有 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. Modbus RTU/ASCII over TCP/IP：
   这是通过 TCP/IP 网络而不是串行线路发送的 RTU 或 ASCII 消息。
5. Modbus RTU/ASCII over UDP/IP：
   这是通过 UDP/IP 网络而不是串行线路发送的 RTU 或 ASCII 消息。

注意：连接类型 3-5 不是 www.modbus.org 指定的标准 Modbus，但为了方便起见，添加了它们。

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

串口设置（Serial Settings）

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

模式

使用此选项可选择 RTU 或 ASCII 模式。默认 RTU。

响应超时

指定 Modbus 轮询在放弃之前应等待从机设备响应的时间长度。默认值为 1000ms。

轮询之间的最小延迟

无论扫描速率如何，此设置都可确保在传输下一个请求之前将延迟降至最低。 此设置的分辨率约为 15 毫秒。在某些计算机上可以获得更好的分辨率，但不是全部。

注意：

1.如果将此值设置为低于 20 毫秒，则无法保证响应和新请求之间的 3.5 个字符的时间间隔。 这是因为 Windows 计划程序每 10 – 20 毫秒切换一次任务。

2.如果轮询串行 RS485 网络中的多个从站，则不应将该值设置为低于 20 毫秒。这是为了确保 3.5 个字符的时间间隔。

3.在 TCP/IP 网络中，小于 20 毫秒是可以的。

4.仅与一个从设备的串行连接小于 20 毫秒即可。

用户波特率

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

远程服务器

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

IP地址

服务器 IP 地址。默认值为 localhost 127.0.0.1

端口

服务器端口号。默认值 502

连接超时

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

高级设置

RTS 切换

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

注意：

如果可能，应避免使用 RTS 控制的 RS232/RS485 转换器。 很难确定以非实时方式关闭发射器的确切时间 Windows 和 Linux 等操作系统。如果过早关闭，字符可能仍会坐着 在FIFO或UART的发射寄存器中，这些字符将丢失。因此奴隶 无法识别该消息。另一方面，如果它关闭得太晚，那么从机的消息 已损坏，主服务器将无法识别该消息。

DSR格式

DSR 指定是否监视 DSR（数据集就绪）信号以进行输出流量控制。如果此成员为 TRUE 且 DSR 处于关闭状态，则输出将挂起，直到再次发送 DSR。

CTS服务

CTS 指定是否监控 CTS（clear-to-send）信号以进行输出流量控制。如果启用此复选框并关闭 CTS，则输出将暂停，直到再次发送 CTS。

DTR公司

DTR 指定在打开端口时是启用还是禁用 DTR。

删除 Echo

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

读/写定义

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

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

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

从站ID

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

函数代码

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

读取函数

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

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

编写函数

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

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

地址

Modbus 协议中的地址令人困惑！某些协议规范使用协议/消息 地址，其他人使用设备寻址。

协议/消息地址

某些协议规范使用从 0 到 65535 计数的协议/消息地址以及 函数代码。这也是新的Modbus规范所使用的。这是里面的地址 通过网络发送的消息。

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

设备地址

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

5 位数字与 6 位寻址

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

这不是 Modbus Poll 的问题。410001变成 10000。“4”被扔掉，其余的 10001 当我们从 0 而不是 1 开始计数时，会减少 1。

地址示例

这些示例显示了在规范使用设备地址时如何设置 Modbus Poll。

读取保持寄存器

您希望每 1000 毫秒从从属 ID 2 读取设备地址 40011 的 20 个寄存器。从“4”中我们知道这是函数 03“读取保持寄存器”。

• 从站 ID = 2
• 函数 = “03 读取保持寄存器 （4x）”
• 地址 = 10（11 减去 1）
• 数量 = 20
• 扫描速率 = 1000

读取离散输入

您希望每 500 毫秒从地址 110201 从 ID 5 读取 1000 个线圈。从“1”中我们知道这是函数 02“读取离散输入”

• 从站 ID = 5
• 函数 = “02 读取离散输入 （1x）”
• 地址 = 10200 （10201 – 1）
• 数量 = 1000
• 扫描率 = 500

扫描速率

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

禁用读/写

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

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

“读/写一次”按钮

出错时禁用

如果出现错误，请禁用读/写。

隐藏名称列

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

单元格中的地址

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

PLC地址（基数1）

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

Enron/Daniel模式

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 个字节而不是 2 个字节的有争议的步骤 Modbus 规范中的术语“保持寄存器”。这意味着对寄存器进行轮询 Enron-Modbus 中的 4×5001 和 4×5002 返回 8 个字节或两个 32 位整数，而 Standard Modbus 只会返回 4 个字节或一个 32 位整数，被视为两个 16 位整数。 此外，Enron-MB 中的轮询寄存器 4×5010 返回第十个 32 位长整数， 而标准 Modbus 会考虑此范围内第五个 32 位长整数的 1/2。

行

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

实时图表

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

注意：

所有图表设置都保存在工作区文件中。保存/打开工作区

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

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

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

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

• 最后停下来：图表停止。
• 最后重新启动：图表重新开始。
• 继续：它一直持续到达到最大点数或按下停止键。

设置

默认情况下，所有 12 个系列都链接到左侧 Y 轴。检查 “右 Y 轴”复选框（如果要将序列链接到右 Y 轴）。

指定

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

显示

• 文件名
• 地址

偏移量可用于在同一 Y 轴上对齐数据点。例如，数据点为 0 或 1 可以偏移，这样它们就不会相互重叠绘制。

缩放功能

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

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

平移功能

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

将数据链接到图表系列

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

导出系列

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

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

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

地址扫描

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

注意：

扫描所有 65535 个地址需要一些时间，具体取决于连接类型、服务器设备等。

导出地址扫描

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

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

显示格式

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

Native Modbus 寄存器

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

• 签署
• 无符号
• 十六进制
• ASCII – 十六进制
• 二元的

32位有符号整数

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

• 有符号整数 Big-endian
• 有符号整数 Little-endian
• 有符号整数大端字节交换
• 有符号整数 Little-endian 字节交换例字节顺序：AB CD（大端）
  十进制数 123456789 或十六进制 07 5B CD 15 在 Modbus 消息中通过线路
  排列时的顺序：07 5B CD 15

32位无符号整数

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

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

64位有符号整数

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

• 有符号整数 Big-endian
• 有符号整数 Little-endian
• 有符号整数大端字节交换
• 有符号整数 Little-endian 字节交换例字节顺序：AB CD EF GH （Big-endian）
  十进制数 -1,234,567,890,123,456,789 或十六进制 EE DD EF 0B 82 16 7E EB
  顺序，因为它们在 Modbus 消息中通过网络出现：EE DD EF 0B 82 16 7E EB

64位无符号整数

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

• 无符号整数 Big-endian
• 无符号整数 Little-endian
• 无符号整数大端字节交换
• 无符号整数 Little-endian 字节交换例字节顺序：AB CD EF GH（Big-endian）
  十进制数 1,234,567,890,123,456,789 或十六进制 11 22 10 F4 7D E9 81 15 在 Modbus 消息中通过网络
  排序：11 22 10 F4 7D E9 81 15

32位浮点数

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

• 浮点 Big-endian
• 浮点 Little-endian
• 浮点大端字节交换
• Float Little-endian 字节交换例字节顺序：AB CD（大端）
  浮点数 123456.00 或十六进制 47 F1 20 00 在 Modbus 消息中通过线路
  排列的顺序：47 F1 20 00

64位双精度浮点数

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

• 双大端
• 双 Little-endian
• 双大端字节交换
• 双 Little-endian 字节交换例字节顺序：AB CD EF GH（大端序）
  浮点数 123456789.00 或十六进制 41 9D 6F 34 54 00 00 00 在 Modbus 消息中通过线路
  排序：41 9D 6F 34 54 00 00 00

保存/打开工作区

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

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

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

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

导出到 csv

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

• 逗号分隔值文件 （*.csv）
  “温度”，“19.7”
• 分号分隔值文件 （*.csv）
  “温度”;”19.7″
• 制表符分隔值文件 （*.txt）
  温度 19.7

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

导出到 Modbus Slave

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

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

考试中心

此测试对话框的目的是帮助 MODBUS 从站设备开发人员使用任何 他们自己作曲的字符串。
列表框显示传输的数据和接收的数据。
您可以在下拉列表框中包含多个测试字符串。输入字符串后，按 “添加到列表”按钮，然后将字符串添加到列表中。
按下“发送”按钮时发送所选字符串。

打开列表

从文件中保留测试字符串。

保存列表

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

清除

清除测试列表。

添加到列表

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

添加检查

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

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

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 对。

TCP/IP 示例

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

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

测试中心字符串文件

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

字符串列表的内容

TestCenter 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

复制

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

注意：

在执行其他命令时使此窗口保持打开状态。

Modbus 数据记录

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

文本文件

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

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

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

日志速率

每次读取

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

选择

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

注意：

如果扫描速率为 10000 毫秒，则设置 1 秒日志速率是没有意义的，因为只有在新数据准备就绪时才会记录数据。

分隔符

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

固定宽度

表示值按列进行组织。

逗点

用逗号分隔的值。

标签

用制表符分隔的值。

仅更改数据时记录日志

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

日志错误

指定记录超时等错误。

日志日期

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

使用“T”作为分隔符

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

日志毫秒

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

日志地址

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

按 ok 时开始记录

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

打开 *mbp 时开始记录

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

立即刷新到文件

这确保了日志行不会在文件系统中兑现，而是立即以物理方式写入。

追加

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

午夜新建日志文件

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

头文件信息

• 插入标题：信息将插入到日志文件的顶部。
  • 命名顶行中的单元格：插入名称。
  • 投票定义：插入 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 电子表格中导入数据。

Microsoft Excel

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

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

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

日志速率

• 每个内容都写着：为所有 Modbus 请求编写日志。将频率记录为扫描速率。
• 选择：指定日志速率（以秒为单位）。日志与扫描速率无关。
  备注：如果扫描速率为 10000 毫秒，则设置 1 秒日志速率是没有意义的，因为只有在新数据准备就绪时才会记录数据。
• 以下时间停止：指定日志行数。请注意，Excel 2003 限制为 65,536 行，Excel 2007 限制为 1,048,576 行。

头文件信息

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

带有标头信息的 Excel 日志。

通信流量

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

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

注意：

此窗口仅显示 Modbus Poll 发送和接收的数据。您不能将其用作数据嗅探器。

在执行其他命令时使此窗口保持打开状态。

OLE/自动化

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

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

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

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

Excel 示例

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

Excel 2007的

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

Excel 2010、2016

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

Excel 示例代码

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

Modbus Poll 安装中还包括一个示例。
开始→所有程序→Modbus Poll → 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()
   ' 创建 Modbus Poll 应用程序对象和两个文档对象
   Set app = CreateObject("Mbpoll.Application")
   Set doc1 = CreateObject("Mbpoll.Document")
   Set doc2 = CreateObject("Mbpoll.Document")
   ' 读取10个保持寄存器，每1000ms读取一次
   res = doc1.ReadHoldingRegisters(1, 0, 10, 1000)
   ' 读取10个线圈状态，每1000ms读取一次
   res = doc2.ReadCoils(1, 0, 10, 1000)
   ' 显示文档窗口（此行被注释，如需使用请取消注释）
   ' doc1.ShowWindow()
   ' 设置连接为 Modbus TCP/IP
   app.Connection = 1 
   ' 设置IP地址为本地主机
   app.IPAddress = "127.0.0.1" 
   ' 设置服务器端口为 502
   app.ServerPort = 502
   ' 设置连接超时时间为 1000ms
   app.ConnectTimeout = 1000
   ' 打开连接
   res = app.OpenConnection()
End Sub

Private Sub Read_Click()
   ' 显示请求的结果
   Cells(5, 7) = doc1.ReadResult() ' 显示保持寄存器的读取结果
   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

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

# 字节序定义
BE = 0
LE = 3
BE_BS = 2
LE_BS = 1

# 创建 Modbus Poll 应用实例
App = win32.Dispatch('Mbpoll.Application')

# 设置连接参数
App.Connection = 1  # 使用 Modbus TCP/IP
App.IPAddress = "127.0.0.1"  # 本地地址

App.ServerPort = 502  # Modbus 端口
App.OpenConnection()  # 打开连接

# 创建 Modbus 显示窗口实例
Win1 = win32.Dispatch("Mbpoll.Document")

# 从从站ID为1的设备读取100个保持寄存器，地址从0 (40001) 开始，每1000ms读取一次
Win1.ReadHoldingRegisters(1, 0, 100, 1000)
# 显示 Modbus 窗口
Win1.ShowWindow()
# 设置显示的行数
Win1.Rows(1)

# 禁用刷新以提高速度
Win1.EnableRefresh = False

# 设置不同的数据格式显示方式
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)

# 为不同格式的数据设置显示名称
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")

# 重新启用刷新
Win1.EnableRefresh = True

# 调整所有列的大小以适应内容
Win1.ResizeAllColumns()
# 调整窗口大小以适应内容
Win1.ResizeWindow()

# 保存配置到文件，指定文件路径
result = Win1.Save("C:\\Users\\UserName\\Desktop\\testfile.mbp")
# 打印保存结果
print(result)

# 打印第二个格式名称，作为示例
print(Win1.GetName(1))

# 等待用户按 Enter 键退出，避免窗口直接关闭
_ = input("Press ENTER to quit:")

连接函数/属性

The following properties and functions do the same as you setup in the connection dialog (F3).

连接

“连接”（Connection） 选择所需的连接。可以选择串行端口或其中一个以太网连接。

属性连接为整数

取值范围

0 = Serial port
1 = Modbus TCP/IP
2 = Modbus UDP/IP
3 = Modbus ASCII/RTU over TCP/IP
4 = Modbus ASCII/RTU over UDP/IP

例如

Connection = 0

波特率

仅适用于连接 = 0

属性波特率与长

300
600
1200
2400
4800
9600 (默认)
14400
19200
38400
56000
57600
115200
128000
153600
230400
256000
460800
921600

例如

BaudRate = 9600

数据位

仅适用于连接 = 0

属性 DataBits 作为整数

取值范围

7
8 (默认)

例如：

DataBits = 8

校验位

仅适用于连接 = 0

作为整数的属性奇偶校验

取值范围

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

例如：

Parity = 2

停止位

仅适用于连接 = 0

属性 StopBits as Integer取值范围

1 （默认）
2

例如：

StopBits = 1

串行端口

仅适用于连接 = 0

属性 SerialPort as Integer取值范围

1…255

默认值 = 1

例如：

SerialPort = 1

模式

仅适用于连接 = 0

属性模式为整数

取值范围

0 = RTU 模式
1 = ASCII 模式

例如：

Mode = 1

删除Echo

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

属性 RemoveEcho as Integer

取值范围

0（默认）
1（删除回声）

例如：

RemoveEcho = 1

响应超时

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

属性 ResponseTimeout 作为整数取值范围

50…100000

默认值 = 1000

例如：

ResponseTimeout = 1000

DelayBetweenPolls

属性 DelayBetweenPolls 作为整数取值范围

0…1000

默认值 = 20

例如：

DelayBetweenPolls = 20

服务器端口

仅适用于 Connection = 1…4

属性 ServerPort as Long取值范围

0…65535

默认值 = 502

例如：

ServerPort = 502

15.3.12. ConnectTimeout

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

仅适用于 Connection = 1…4

属性 ConnectTimeout as Integer

取值范围

100…30000毫秒

默认值 = 1000ms

例如：

ConnectTimeout = 1000

IP版本

仅适用于 Connection = 1…4

属性 IPVersion as Integer

取值范围

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

例

IPVersion = 4

开放连接

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

函数 OpenConnection（） 为整数

参数

此函数没有参数。

返回值

对于错误 3-5：请检查您是否拥有最新的串口驱动程序。

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

Public app As Object
Dim res As Integer

' 创建一个指向 Modbus Poll 的对象
Set app = CreateObject("Mbpoll.Application")

' 选择 Modbus TCP/IP 协议
app.Connection = 1

' 设置 IP 协议版本为 IPv4
app.IPVersion = 4

' 设置目标设备的 IP 地址
app.IPAddress = "192.168.1.27"

' 设置服务器端口，默认为 502
app.ServerPort = 502

' 设置连接超时时间为 1000 毫秒
app.ConnectTimeout = 1000

' 设置响应超时时间为 1000 毫秒
app.ResponseTimeout = 1000

' 尝试打开连接，并将结果存储在变量 res 中
res = app.OpenConnection()

Python 示例：如何设置串行连接

import win32com.client as win32

# 创建 Modbus Poll 应用程序对象
App = win32.Dispatch('Mbpoll.Application')

# 设置为串行连接
App.Connection = 0            
# 选择 COM 端口 3
App.SerialPort = 3            
# 设置波特率为 9600
App.BaudRate = 9600           
# 设置奇偶校验为无
App.Parity = 0                
# 设置模式为 RTU
App.Mode = 0                  
# 设置响应超时时间为 1000ms
App.ResponseTimeout = 1000    
# 设置两次请求之间的最小间隔时间为 20ms
App.DelayBetweenPolls = 20    
# 打开连接
App.OpenConnection

# 创建一个 Modbus 显示窗口对象 Win1
Win1 = win32.Dispatch("Mbpoll.Document")

# 从从站ID为1的设备读取10个保持寄存器，地址从0 (40001) 开始，每1000ms读取一次
Win1.ReadHoldingRegisters(1, 0, 10, 1000)
# 显示 Modbus 窗口
Win1.ShowWindow()
# 设置显示的行数为10
Win1.Rows(0)

# 禁用刷新以提高速度
Win1.EnableRefresh = False

# 为寄存器设置名称
Win1.SetName(0, "Register 0")

# 重新启用刷新
Win1.EnableRefresh = True

# 调整所有列的大小以适应内容
Win1.ResizeAllColumns ()
# 调整窗口大小以适应内容
Win1.ResizeWindow()

# 等待用户按 Enter 键退出
_ = input("Press ENTER to quit:")  

紧密连接

函数 CloseConnection（） 为整数

参数

此函数没有参数。

返回值

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

ShowCommunicationTraffic

显示通信流量窗口。

函数 ShowCommunicationTraffic()

参数

此函数没有参数。

返回值

没有

CloseCommunicationTraffic

如果显示，则关闭通信流量窗口。

函数 CloseCommunicationTraffic()

参数

此函数没有参数。

返回值

没有

读取函数

以下函数的操作与您在读/写定义对话框 （F8） 中设置的相同。 读取函数与 Modbus Poll 文档相关联。（包含数据的窗口）

例如：

' 首先需要创建一个 Modbus Poll 文档对象
Public doc As Object

' 创建 Modbus Poll 文档对象实例
Set doc = CreateObject("Mbpoll.Document")
' 从从站 ID 为 1 的设备读取 100 个线圈状态，地址从 0 开始，每 1000 毫秒读取一次
res = doc.ReadCoils(1, 0, 100, 1000) ' 读取 100 个线圈每 1000ms

注意：必须先创建 Read，然后才能使用属性获取数据。

读取线圈 ReadCoils

Modbus 功能代码 01

函数 ReadCoils（SlaveID 为整数，地址为长，数量为整数，ScanRate 为长）为整数

参数

奴隶ID：从地址 1 到 255
地址：数据地址（以 0 为基数）
数量：数据数量。1 至 2000
扫描速率：0 至 3600000msReturn value

True if success. False if not success

读离散输入 ReadDiscreteInputs

Modbus 功能码 02

函数 读离散输入(从站ID As 整型, 地址 As 长整型, 数量 As 整型, 扫描率 As 长整型) As 整型

参数

• 从站ID: 从站地址 1 至 255
• 地址: 数据地址（基数 0）
• 数量: 数据数量。1 至 2000
• 扫描率: 0 至 3600000ms

返回值

• 成功返回 True。失败返回 False。

读保持寄存器 ReadHoldingRegisters

Modbus 功能码 03

函数 读保持寄存器(从站ID As 整型, 地址 As 长整型, 数量 As 整型, 扫描率 As 长整型) As 整型

参数

• 从站ID: 从站地址 1 至 255
• 地址: 数据地址（基数 0）
• 数量: 数据数量。1 至 125
• 扫描率: 0 至 3600000ms

返回值

• 成功返回 True。失败返回 False。

读输入寄存器 ReadInputRegisters

Modbus 功能码 04

函数 读输入寄存器(从站ID As 整型, 地址 As 长整型, 数量 As 整型, 扫描率 As 长整型) As 整型

参数

• 从站ID: 从站地址 1 至 255
• 地址: 数据地址（基数 0）
• 数量: 数据数量。1 至 125
• 扫描率: 0 至 3600000ms

返回值

• 成功返回 True。失败返回 False。

自动化写入函数

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

写单个线圈 WriteSingleCoil

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

函数 写单个线圈(从站ID As 整型, 地址 As 长整型) As 整型

参数

• 从站ID: 从站地址 0 至 255
• 地址: 数据地址（基数 0）

返回值

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

写单个寄存器 WriteSingleRegister

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

函数 写单个寄存器 (从站ID As 整型, 地址 As 长整型) As 整型

参数

• 从站ID: 从站地址 0 至 255
• 地址: 数据地址（基数 0）

返回值

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

写多个线圈 WriteMultipleCoils

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

函数 写多个线圈(从站ID As 整型, 地址 As 长整型, 数量 As 整型) As 整型

参数

• 从站ID: 从站地址 0 至 255
• 地址: 数据地址（基数 0）
• 数量: 数据数量。1 至 1968

返回值

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

写多个寄存器 WriteMultipleRegisters

Modbus 功能码 16。
写入

写数组中存储的寄存器。

函数 写多个寄存器(从站ID As 整型, 地址 As 长整型, 数量 As 整型) As 整型

参数

• 从站ID: 从站地址 0 至 255
• 地址: 数据地址（基数 0）
• 数量: 数据数量。1 至 123

返回值

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

Python 示例

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

import sys
import time
import win32com.client as win32

# 创建Modbus Poll应用程序实例
App = win32.Dispatch('Mbpoll.Application')

# 设置连接类型为TCP/IP
App.Connection = 1            
App.IPAddress = "127.0.0.1"  # 设置IP地址

App.ResponseTimeout = 1000    # 设置响应超时时间为1000毫秒
App.DelayBetweenPolls = 20    # 设置请求间最小间隔为20毫秒
App.ConnectTimeout = 500      # 设置连接超时时间为500毫秒

App.ServerPort = 502  # 设置服务器端口为502
result = App.OpenConnection  # 尝试打开连接

if result != 0:
   print("Connection failed. Error: ", result)  # 连接失败时输出错误信息
   sys.exit()  # 退出程序

# 创建一个名为Win1的Modbus显示窗口
Win1 = win32.Dispatch("Mbpoll.Document")

# 从从站ID 1的地址0 (40001)开始，每1000ms读取10个保持寄存器
Win1.ReadHoldingRegisters(1, 0, 10, 1000)
# 显示Modbus窗口
Win1.ShowWindow()
# 显示10行
Win1.Rows(0)
# 调整窗口大小以适应网格
Win1.ResizeWindow()

time.sleep(1.0) # 等待读取完成

if Win1.ReadResult == 0:    # 检查读取结果
   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))

# 在Modbus Poll的内部数组中准备要写入的数据
Win1.SRegisters(0, 1)   # 注意，这里的1不是Modbus地址，而是数组的索引
Win1.SRegisters(1, 10)
Win1.SRegisters(2, 100)
Win1.SRegisters(3, 1000)
Win1.SRegisters(4, 10000)
# 写入寄存器。这个函数不会在Modbus Poll中创建窗口
# 使用函数 <<WriteMultipleRegistersWin>> 来创建数据窗口
Win1.WriteMultipleRegisters(1, 0, 5)

_ = input("Wait for write Press ENTER:")  # 等待写入，按回车继续

if Win1.WriteResult == 0:    # 检查写入结果
   print("Modbus write success")
else:
   print("Write failed error: = ", Win1.WriteResult)

_ = input("Press ENTER to quit:")  # 按回车退出

15.6. 各种功能

各种功能与 Modbus Poll 文档相关联。（包含数据的窗口）

15.6.1. ShowWindow

默认情况下，Modbus 文档窗口处于隐藏状态。ShowWindow 函数使 Modbus Poll 可见，并显示包含数据内容的文档。

函数 ShowWindow()参数

此函数没有参数。返回值

没有

15.6.2. GetTx计数

获取请求数。

函数 GetTxCount（） 只要参数

此函数没有参数。返回值

请求数。

获取接收计数

获取响应数量。

函数 获取接收计数() As 长整型

参数

此函数没有参数。

返回值

响应数量。

获取名称

获取值的名称。

函数 获取名称(索引 As 整型) As 字符串

参数

索引：索引0对应于第一个Modbus地址。

返回值

名称。

设置名称

更改值的名称。函数 设置名称(索引 As 整型, 名称 As 字符串)

参数

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

返回值

无

格式化全部

使用选定的格式格式化所有值单元格。

函数 格式化全部(格式 As 整型)

参数

格式：值单元格的格式。

返回值

无

获取格式

获取Modbus值的显示格式。

函数 获取格式(索引 As 整型) As 整型

参数
索引：索引0对应于第一个Modbus地址。

返回值

注意：

此设置仅用于显示。使用 Get/Set 值函数时，仍需要使用 byteOrder 来获取正确的字节序。

15.6.8. SetFormat

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

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

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

没有

15.6.9. ResizeWindow

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

函数 ResizeWindow()参数

此函数没有参数。返回值

没有

15.6.10. ResizeAllColumns

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

函数 ResizeAllColumns()参数

此函数没有参数。返回值

没有

15.6.11. 行

指定网格中的行数。

函数行 （NumberRows）参数

数字行：网格中的行数。

返回值

没有

读取结果

使用此属性来检查是否成功建立了与读取操作的通信。

属性 读取结果 As 整型

参数

此函数没有参数。

返回值

写入结果

使用此函数来检查写入操作是否成功。
在从从站获得结果之前，值为数据未初始化。参见读取结果以获取可能的值列表。

属性

写入结果 As 整型

返回值
以整型返回写入结果。

保存

保存当前窗口。函数 保存(路径名 As 字符串) As 布尔型

参数
路径名：应保存文件的完全限定路径。

返回值
Boolean 布尔型

示例

# 首先需要一个Modbus Poll文档。
Public doc As Object

Set doc = CreateObject("Mbpoll.Document")
res = doc.ReadCoils(1, 0, 100, 1000) # 每1000毫秒读取100个线圈
res = doc.Save("C:\\Users\\UserName\\Desktop\\testfile.mbp")    # 将文档保存到桌面的testfile.mbp文件

自动化数据属性

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

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

一个没有后缀，例如SRegisters，用于从内部写/读数组中设置或获取值。

一个带有Win后缀，例如SRegistersWin，用于直接从数据窗口设置或获取值。这在使用数据窗口进行写操作（例如WriteMultipleRegistersWin）时使用。

示例 1:

# 假设首先创建了doc。参见Excel示例。
# 在用于稍后写操作的数据数组中，向索引0写入1
doc.SRegisters(0) = 1
doc.SRegisters(1) = 10
doc.SRegisters(2) = 1234
# 将存储在Modbus Poll内部数组的3个寄存器
# 写入Modbus地址100（40101）
# 不创建窗口
res = doc.WriteMultipleRegisters(1, 100, 3)
# 上述示例不创建数据窗口，只是执行单次Modbus写操作。

示例 2，浮点数值:
写入3个浮点数值。

# 假设首先创建了doc。参见Excel示例。
doc.Floats(0) = 1.3
doc.Floats(2) = 10.5
doc.Floats(4) = 1234.12
# 将6个寄存器写入Modbus Poll
res = doc.WriteMultipleRegisters(1, 0, 6)
# 写入6个寄存器，因为浮点数值是32位宽。

示例 3:
创建一个每1000ms写入3个寄存器的窗口。

# 假设首先创建了doc。参见Excel示例。
# 创建一个窗口，该窗口每1000ms写入内容
res = doc.WriteMultipleRegistersWin(1, 100, 3, 1000)
# 向数据窗口的第一个单元格写入1
doc.SRegistersWin(0) = 1
doc.SRegistersWin(1) = 10
doc.SRegistersWin(2) = 1234
# 现在每1000ms就将3个寄存器写入从站id 1地址100

在这些代码示例中，doc是Modbus Poll文档的一个实例，用于执行各种Modbus操作，如写入寄存器。示例展示了如何使用不带Win后缀的属性直接操作内部数组，以及如何使用带Win后缀的属性操作与数据窗口关联的值。

线圈, CoilsWin

Property Coils(Index As Integer) As IntegerDescription

Sets a coil in the write array structure or return a coil from the read array.Syntax

Coils(Index) [=newvalue]

短整型寄存器, SRegistersWin

Property SRegisters(Index As Integer) As IntegerDescription

Sets a register in the write array structure or return a register from the read array.Syntax

SRegisters(Index) [=newvalue]

长整型寄存器, URegistersWin

属性 URegisters（Index As Integer） As Long描述

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

URegisters（索引） [=newvalue]

32位整型、Ints_32Win

属性 Ints_32（Index As Integer） As Double描述

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

Ints_32（索引） [=newvalue]

32位无符号整型、UInts_32Win

属性 UInts_32（index as integer） as double描述

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

UInts_32（索引） [=新值]

64位整型、Ints_64Win

属性 Ints_64（Index As Integer） As Double描述

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

Ints_64（索引） [=新值]

64位无符号整型、UInts_64Win

属性 UInts_64（Index As Integer） As Double描述

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

UInts_64（索引） [=新值]

浮点数，FloatsWin

属性 floats（index as integer） as single描述

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

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

双精度浮点数，DoublesWin

属性 doubles（index as integer） as double描述

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

双打（索引） [=newvalue]

字节顺序

属性 ByteOrder As Integer描述

设置 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语法

ByteOrder [=新值]

15.8. 写入函数（创建数据窗口）

以下函数的操作与您在读/写定义对话框 （F8） 中设置的相同。
这些函数创建一个数据窗口，并根据扫描速率写入数据窗口中的数据内容。

15.8.1. WriteSingleCoilWin

Modbus 功能代码 05。

函数 WriteSingleCoilWin（SlaveID As Integer， Address As Long， ScanRate As Long） As Integer参数

奴隶ID：从地址 1 到 255
地址：数据地址（基数 0）
扫描速率：0 到 3600000ms返回值

如果成功，则为真。如果不是成功，则为假

15.8.2. WriteSingleRegisterWin

Modbus 功能代码 06。

函数 WriteSingleRegisterWin（SlaveID As Integer， Address As Long， ScanRate As Long） As Integer参数

奴隶ID：从地址 1 到 255
地址：数据地址（基数 0）
扫描速率：0 到 3600000msReturn value

True if success. False if not success

Python Example how to open a window and write a single register every 1000 ms

15.8.3. WriteMultipleCoilsWin

Modbus 功能代码 15.

函数 WriteMultipleCoilsWin（SlaveID 为整数，地址为长，数量为整数，ScanRate 为长）为整数参数

奴隶ID：从地址 1 到 255
地址：数据地址（以 0 为基数）
数量：数据数量。1 至 1968
扫描速率：0 至 3600000ms返回值

如果成功，则为真。如果不是成功，则为假

15.8.4. WriteMultipleRegistersWin

Modbus 功能代码 16.

函数 WriteMultipleRegistersWin（SlaveID 为整数，地址为长，数量为整数，ScanRate 为长）为整数参数

奴隶ID：从地址 1 到 255
地址：数据地址（以 0 为基数）
数量：数据数量。1 至 123
扫描速率：0 至 3600000ms返回值

如果成功，则为真。如果不是成功，则为假

16. 异常和错误消息

Modbus 异常和错误消息在 2 中以红色文本显示^钕行。

16.1. Modbus异常代码

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

16.2. Modbus Poll 错误消息

Modbus Poll 9.9.2.1690中文版下载

白银会员¥2.39

黄金会员免费

资源价格 ¥3.99 销售数量 901 发布时间 2024年3月24日 更新时间 2024年4月22日

立即下载 开通会员

已付费？登录 或 刷新