Modbus Poll用户手册（中文版）

ModbusRelated产品推荐：peidianxiang.taobao.com

Modbus Poll简介

Modbus poll是一款非常受欢迎的Modbus主站设备仿真器，支持Modbus RTU、ASCII、TCP/IP等协议模式，能够让Modbus通信设备人员测试和模拟使用通信协议，从而更好的对设备进行监控、测试和debug，也便于观察Modbus通讯过程中的各种messagedata，不仅节省大量的time，还大大的提高了工作效率。

它支持多Document接口，可以同时监视多个从机设备/data域。每个窗口简单地设定从设备ID，Function，address，大小和轮询间隔。你可以从任意一个窗口读写register和线圈。如果你想改变一个单独的register，简单地双击这个值即可。或者你可以改变多个register/线圈值。提供data的多种format方式，比如浮点、双精度、长整型（可以endianness列交换）。

Modbus PollOperationsystem要求

硬件要求

处理器：推荐 1 GHz 或更快
内存：1 GB RAM
硬盘：5 MB 可用硬盘空间
分辨率：1024 x 768 及以上

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

终止用户许可协议

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

版权。
Modbus Poll（“软件”）版权所有 2002-2022 归 Witte Software，All rights reserved。

评估和Register。
这不是free软件。特此授权您在 30 天内free使用本软件进行评估。

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

在 30 天评估期后Unregistered使用该软件违反了美国和国际版权法。

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

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

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

分配。
如果您不包含您的许可密钥，您特此获得许可Copy该软件；将原件的准确副本提供给任何人；并通过电子方式以未经修改的形式分发软件。明确禁止您对任何此类副本收费。

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

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

Modbus PollFunction

connect

Modbus 从设备轮询读/写data，使用：

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

支持的 Modbus Function

• 01：读取线圈
• 02：Read discrete inputs
• 03：Read and hold register
• 04：Read input register
• 05：写单线圈
• 06：写单个register
• 15：写多个线圈
• 16：写多个register
• 17：报告服务器ID
• 22：屏蔽写register
• 23：读/写register
• 43/14：读取设备标识

data记录

• 将data记录到Text文件
• 将data直接记录到 Excel 中

Display format

• 每个单元格都可以单独format化。
• 有符号 16 位register
• 无符号 16 位register
• hexadecimal
• binary
• 具有任何字/byte order的 32 位有符号整数
• 具有任何字/byte order的 32 位无符号整数
• 具有任何字/byte order的 64 位有符号整数
• 具有任何字/byte order的 64 位无符号整数
• 具有任何字/byte order的 32 位浮点数
• 具有任何字/byte order的 64 位双浮点数

其他Function

• 用于与 Excel VBA、Python 等接口的 OLE/自动化。
• 监控data流量
• 打印和打印预览
• 字体选择
• 有条件的颜色
• 缩放
• 实时图表

概述

Modbus Poll 支持多窗口界面，可以同时监控多个Modbus从站和data area。对于每个窗口，只需指定Modbus从站的ID、function code、address、Length和轮询time，即可从任何窗口读取和写入register和线圈。。

使用说明

按 F1可以获取与当前选定项目Related的帮助Document。

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

命名单元格

您可以在此处键入任何Text以指定值单元格。您还可以从 Excel 单元格中Copy/粘贴Text。

值单元格

显示 Modbus register的data值。如果您双击一个值单元格，一个对话框允许您将一个新值写入从设备。在值单元格中键入数字也会显示对话框。可以选择用于写入值的 Modbus Function。

复选框“Close dialog on Response ok”用于在成功send值时自动Close对话框。当要更改大量值时，这很方便。这样可以快速选择一个新单元格，然后再次键入一个新值。

更改字体

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

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

有条件的颜色

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

• 默认颜色：如果没有条件颜色评估为真，则使用此颜色。
• Rules 1：如果表达式Computation result为真，则使用此颜色选择。
• Rules 2：如果表达式Computation result为真，则使用此颜色选择。Rules 2 优先于Rules 1。

7种比较运算符

• 未使用
• 等于
• 比…更棒
• 少于
• 大于或等于
• 小于或等于
• 和

当data type为浮点型或 32 位长型时，不能使用“与”运算符。如果选择“and”，则条件值以hexadecimal数字形式输入。如果单元格和条件值中的任何位为 1，则Computation result为真。

颜色示例

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

缩放

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

(X1,Y1) 和 (X2,Y2)

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

小号l o p e = m =是2 -是1X2 – X1小号l○pe=米=是2-是1X2-X1线方程

是=米⋅ ( X- X1 ) + Y1是=米⋅(X-X1)+是1精确

小数点后的位数。使能够

必须Enable以缩放来自 Modbus 服务器/从站的值。如果选择的不是 16/32 位整数Display format，则会自动禁用缩放。

实时图表

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

打开一个新窗口

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

connect对话框

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

• 按 F3
• 从connect菜单中选择connect

联系

有 5 种不同的connectType：

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

connectType 3-5 不是 www.modbus.org指定的标准 Modbus，但为方便起见添加了它们。

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

串行设置

使用这些参数设置串行端口设置。它们仅在connectType为“串行端口”时可用。模式

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

指定 Modbus Poll 在放弃之前应等待从设备Response的timeLength。默认值为 1000 毫秒。轮询之间的最小延迟

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

如果将此值设置为低于 20 毫秒，则无法保证Response和新Request之间的 3.5 个字符的time间隔。这是因为 Windows 调度程序每 10 到 20 毫秒Switch一次任务。如果您在串行 RS485 网络中轮询多个从站，则不应将该值设置为低于 20 毫秒。这是为了确保 3.5 个字符的time间隔。在 TCP/IP 网络中，少于 20 毫秒是可以的。仅与一台从设备的串行connect小于 20 毫秒是可以的。

远程服务器

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

服务器 IP address。默认为 localhost 127.0.0.1港口

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

用于建立connect的最长time。默认 1000

高级设置

RTS Switch

RTS Toggle 指定如果byte可用于传输，RTS 线将处于高电平。send完所有缓冲byte后，RTS 线将为低电平。
如果您有一个没有自动方向switch的 232/485 转换器，您可以使用它来Switch方向。

如果可能，应避免使用 RTS 控制的 RS232/RS485 转换器。对于 Windows 和 Linux 等非实时Operationsystem，很难确定Close发射机的确切time。如果过早Close，字符可能仍位于 FIFO 或 UART 的sendregister中，这些字符将丢失。因此从站将无法识别该消息。另一方面，如果Close得太晚，则从站的消息被破坏，主站将无法识别该消息。

DSR

DSR 指定是否监视 DSR（data集就绪）信号以进行输出流控制。如果此成员为 TRUE 且 DSR 已Close，则输出将暂停，直到再次send DSR。中旅

CTS 指定是否监视 CTS（Clearsend）信号以进行输出流控制。如果Enable此复选框并Close CTS，则输出将暂停，直到再次send CTS。DTR

DTR 指定在打开端口时是否Enable或禁用 DTR。Remove回声

如果您equipment或 RS232/RS485 转换器回显刚刚send的字符。

读/写定义

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

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

从站 ID

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

function code

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

5.2.1。读取函数

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

• 01：读取线圈（0x）
• 02：Read discrete inputs (1x)
• 03：Read and hold register（4x）
• 04：Read input register（3x）

5.2.2. 编写函数

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

• 05：Write into a single coil（写入Coil status）
• 06：Write to a single register（写入保持register）
• 15：Write multiple coils（Writes to Coils）
• 16：Write multiple registers（Writes to Holding registers）

address

Modbus protocol中的address令人困惑！一些协议规范使用协议/消息address，而另一些则使用设备寻址。

5.3.1。协议/消息address

一些协议规范使用从 0 到 65535 计数的协议/消息address以及Function代码。这也是新的 Modbus 规范使用的内容。这是通过网络send的消息中的address。

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

5.3.2. Device address

一些协议规范使用Device address/register。register从 1 开始计数。第一个数字描述要使用的Function。这意味着Device address 40101 由address 100 标识。“4”表示保持register，4x register从 1 开始计数。更令人困惑的是：4x 表示Function代码 03，3x 表示Function代码 04！

5.3.3. 5 位与 6 位寻址

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

这不是 Modbus Poll 的问题。410001 变为 10000。“4”被丢弃，其余的 10001 减 1，因为我们从 0 而不是 1 计数。

5.3.4. address示例

这些示例显示了如果规范使用Device address，如何设置 Modbus 轮询。

Read and hold register

您希望每 1000 毫秒从从 ID 2 的Device address 40011 读取 20 个register。从“4”我们知道这是Function03“Read and hold register”。

• 从站 ID = 2
• Function =“03 Read and hold register (4x)”
• address = 10（11 减 1）
• quantity = 20
• 扫描率 = 1000

Read discrete inputs

您想每 500 毫秒从从站 ID 5 的address 110201 读取 1000 个线圈。从“1”我们知道这是Function02“Read discrete inputs”

• 从站 ID = 5
• Function =“02 Read discrete inputs (1x)”
• address = 10200 (10201 – 1)
• quantity = 1000
• 扫描率 = 500

扫描率

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

读/写禁用

“Read/Write Disabled”复选框可用于临时Enable或禁用此窗口的通信。然后显示Text（禁用）以及 Tx 和Error count器。

5.5.1。出错时禁用

出现Error时禁用读/写。

隐藏名称列

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

单元格中的address

如果Enable，address也会显示在值单元格中，例如：2000 = 00000

PLC address（基数 1）

此选项将address显示为Device address。

安然/丹尼尔模式

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

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

• 4×5001 到 4×5999 假定为 32 位长整数（每个register 4 bytes）。
• 4×7001 到 4×7999 假定为 32 位浮点数（每个register 4 bytes）。

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

行

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

实时图表

使用此命令可在图表中实时绘制多达 12 个data系列。
实时图表是高速的，并且能够在receive到新data时尽快绘制新线。

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

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

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

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

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

• End时停止：图表停止。
• End时重新开始：图表重新开始。
• 继续：它一直持续到达到最大点数或按下停止。

设置

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

• 颜色
• 右 Y 轴
• 标题
• 抵消

显示

• 文件名
• address

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

缩放Function

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

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

平移Function

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

将data链接到图表系列

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

Copy系列

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

分隔符：选择在Text文件中分隔值的字符。使用 Excel 选项卡。此外，还给出了一些附加信息。

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

Display format

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

原生 Modbus register

16 位 Modbus register可以以 4 种不同的模式显示。

• 签
• 未签名
• hexadecimal
• binary

32 位有符号整数

这结合了 2 个 16 位 Modbus register。它可以以 4 种不同的字/byte order显示。

• 有符号整数 Big-endian
• 有符号整数 Little-endian
• 有符号整数大端byte交换
• 有符号整数小端byte交换例子byte order：AB CD (Big-endian)
  decimal数 123456789 或hexadecimal07 5B CD 15
  它们在 Modbus 消息中通过线路的顺序：07 5B CD 15

32 位无符号整数

这结合了 2 个 16 位 Modbus register。它可以以 4 种不同的字/byte order显示。

• 无符号整数 Big-endian
• 无符号整数小端序
• 无符号整数大端byte交换
• 无符号整数小端byte交换例子byte order：AB CD (Big-endian)
  decimal数 123456789 或hexadecimal07 5B CD 15
  它们在 Modbus 消息中通过线路的顺序：07 5B CD 15

64 位有符号整数

这结合了 4 个 16 位 Modbus register。它可以以 4 种不同的字/byte order显示。

• 有符号整数 Big-endian
• 有符号整数 Little-endian
• 有符号整数大端byte交换
• 有符号整数小端byte交换例子byte order：AB CD EF GH（大端）
  decimal数 -1,234,567,890,123,456,789 或hexadecimalEE DD EF 0B 82 16 7E EB
  在 Modbus 消息中通过线路的顺序：EE DD EF 0B 82 16 7E EB

64 位无符号整数

这结合了 4 个 16 位 Modbus register。它可以以 4 种不同的字/byte order显示。

• 无符号整数 Big-endian
• 无符号整数小端序
• 无符号整数大端byte交换
• 无符号整数小端byte交换例子byte order：AB CD EF GH（大端）
  decimal数 1,234,567,890,123,456,789 或hexadecimal11 22 10 F4 7D E9 81 15
  它们在 Modbus 消息中通过线路的顺序：11 22 10 F4 7D E9 81 15

32 位浮动

这结合了 2 个 16 位 Modbus register。它可以以 4 种不同的字/byte order显示。

• 浮点大端
• 浮点小端序
• 浮点大端byte交换
• 浮点小端byte交换例子byte order：AB CD (Big-endian)
  浮点数 123456.00 或hexadecimal47 F1 20 00
  它们在 Modbus 消息中通过线路的顺序：47 F1 20 00

64 位双精度

这结合了 4 个 16 位 Modbus register。它可以以 4 种不同的字/byte order显示。

• 双大端
• 双小端序
• 双大端byte交换
• 双小端byte交换例子byte order：AB CD EF GH (Big-endian)
  浮点数 123456789.00 或hexadecimal41 9D 6F 34 54 00 00 00
  它们在 Modbus 消息中通过线路的顺序：41 9D 6F 34 54 00 00 00

保存/打开工作区

如果您打开许多Related的 Modbus 窗口，将所有打开和排列的 Modbus 窗口的当前布局的快照保existence一个工作区中会很方便。

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

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

export为csv

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

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

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

测试中心

此测试对话框的目的是帮助 MODBUS 从设备开发人员使用他们自己组成的任何字符串来测试设备。
列表框显示send的data以及receive的data。
您可以在下拉列表框中有多个测试字符串。输入字符串后，按“添加到列表”button，然后将字符串添加到列表中。
按下“send”button时send选定的字符串。打开列表

从文件中休息测试字符串。保存列表

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

Clear测试列表。添加到列表

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

在输入字符串的末尾添加 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 个保持register。

00 00 00 00 00 06 01 03 00 00 00 0A

前 6 个byte是 TCP/IP 标头。

测试中心字符串文件

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

10.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

Copy

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

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

Modbus data记录

您可以将data记录到Text文件或直接记录到 Microsoft Excel。

Text文件

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

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

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

11.1.1. 日志率

每次读

为所有 Modbus Request编写日志行。记录频率作为扫描速率。选择

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

如果扫描速率是例如 10000 毫秒，那么设置 1 秒的日志速率是没有意义的，因为只有在新data准备好时才会记录data。

11.1.2. 分隔符

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

表示值按列组织。逗号

用逗号分隔的值。Tags

由制表符分隔的值。

11.1.3. 仅记录data更改

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

11.1.4. 记录Error

指定记录超时等Error。

11.1.5。记录日期

指定将当前日期添加到日志time。

11.1.6。记录毫秒

指定将毫秒添加到日志time。

11.1.7。日志address

指定将 Modbus address添加到日志中。

11.1.8。按下确定时开始记录

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

11.1.9。打开 *mbp 时启动日志

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

11.1.10。立即refresh归档

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

11.1.11。附加

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

11.1.12。午夜的新日志文件

Close当前日志文件并在午夜开始一个新文件。time戳会添加到您的文件名中。

具有固定宽度的Text文件示例：

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 电子表格中导入data。

微软Excel

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

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

记录时不要触摸 Excel 表，因为这会中断记录。

11.2.1. 日志率

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

11.2.2. 标头信息

• 插入标题：信息插入到 Excel 工作表的最顶部 3 行。
  • 在第一行命名单元格：在第 3 行插入名称。
  • 轮询定义：在第 2 行插入 ID、Function 等。
  • 名称：在第 1 行插入一个日志名称。

带有标题信息的 Excel 日志。

通信流量

选择菜单 Display→Communication 以显示串行线路或以太网电缆上的流量。使用停止button暂时停止更新以进行检查。

使用Copybutton将选定的行Copy到剪贴板。

此窗口仅显示 Modbus Poll send和receive的data。您不能将其用作data嗅探器。

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

OLE/自动化

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

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

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

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

Excel 示例

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

13.1.1. Excel 2007

1. 单击 Microsoft office button，然后单击 Excel 选项。
2. 单击流行，然后选中Function区复选框中的显示开发人员选项卡。
   请注意，Function区是 Microsoft fluent 用户界面的一部分。

13.1.2. Excel 2010, 2016

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

13.1.3. Excel 示例代码

此示例打开两个窗口。一个读数register和另一个读数线圈。
Modbus Poll 是隐藏的，但您可以通过Cancel注释“ShowWindow”行来显示它。这将显示其中一个窗口。

Modbus Poll 安装中还包含一个示例。
开始 → 所有程序 → 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

Python 示例

这个 Python 示例打开一个窗口并设置所有可能的data format。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()

print (Win1.GetName(1))

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

connectFunction/属性

以下属性和Function与您在connect对话框 (F3) 中的设置相同。

13.3.1. 联系

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

属性connect为整数effective值

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

13.3.2. Baud rate

仅适用于 Connection = 0

属性BaudRate as Longeffective值

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

BaudRate = 9600

13.3.3. data bit

仅适用于 Connection = 0

属性DataBits为整数effective值

7
8（默认）
例子

DataBits = 8

13.3.4. 平价

仅适用于 Connection = 0

属性奇even parity为整数effective值

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

Parity = 2

13.3.5. stop bit

仅适用于 Connection = 0

属性StopBits为整数effective值

1（默认）
2
例子

StopBits = 1

13.3.6。串行端口

仅适用于 Connection = 0

将SerialPort属性设为整数effective值

1…255

默认值 = 1例子

SerialPort = 1

13.3.7. 模式

仅适用于 Connection = 0

属性模式为整数effective值

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

Mode = 1

13.3.8. Remove回声

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

属性RemoveEcho为整数effective值

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

RemoveEcho = 1

13.3.9。Response超时

ResponseTimeout 指定 Modbus Poll 在放弃之前应等待从设备Response的timeLength（以 ms 为单位）。

属性ResponseTimeout为整数effective值

50…100000

默认值 = 1000例子

ResponseTimeout = 1000

13.3.10。轮询之间的延迟

属性DelayBetweenPolls为整数effective值

0…1000

默认值 = 20例子

DelayBetweenPolls = 20

13.3.11。服务器端口

仅适用于 Connection = 1…4

属性ServerPort as Longeffective值

0…65535

默认值 = 502例子

ServerPort = 502

13.3.12。connect超时

ConnectTimeout 指定 Modbus Poll 等待 TCP/IP connect成功的timeLength。

仅适用于 Connection = 1…4

属性ConnectTimeout为整数effective值

100…30000 毫秒

默认值 = 1000 毫秒例子

ConnectTimeout = 1000

13.3.13。IP版本

仅适用于 Connection = 1…4

属性IPVersion为整数effective值

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

IPVersion = 4

13.3.14。开放connect

打开使用 Connection 属性选择的connect。

函数OpenConnection () 作为整数参数

这个函数没有参数。返回值

Error3-5：请检查您是否有最新的串口驱动程序。

Error	描述
0	成功
1	串口不可用
3	串行端口。无法从端口驱动程序获取当前设置。
4	串行端口。串行端口驱动程序不接受端口设置。
5	串行端口。串行端口驱动程序不接受超时设置。
12	TCP/UDP connect失败。WSA 启动
13	TCP/UDP connect失败。connectError
14	TCP/UDP connect失败。暂停
15	TCP/UDP connect失败。IOCTL
17	TCP/UDP connect失败。套接字Error
21	TCP/UDP connect失败。address信息
255	connect已打开

Excel 示例如何打开 Modbus TCP/IP connect

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 示例如何设置串行connect

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:")

Closeconnect

函数CloseConnection () 作为整数参数

这个函数没有参数。返回值

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

ShowCommunicationTraffic

显示通信流量窗口。

函数ShowCommunicationTraffic ()参数

这个函数没有参数。返回值

没有

Close通讯交通

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

函数CloseCommunicationTraffic ()参数

这个函数没有参数。返回值

没有

读取函数

以下Function与您在读/写定义对话框 (F8) 中的设置相同。读取函数与 Modbus Poll DocumentRelated联。（data窗口）例子

' 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

您必须先创建读取，然后才能使用属性获取data。

读取线圈

Modbusfunction code01

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

SlaveID：从机address 1 到 255
Address：dataaddress（Base 0）
Quantity：data个数。1 到 2000
扫描速率： 0 到 3600000 毫秒返回值

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

Read discrete inputs

Modbusfunction code02

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

SlaveID：从机address 1 到 255
Address：dataaddress（Base 0）
Quantity：data个数。1 到 2000
扫描速率： 0 到 3600000 毫秒返回值

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

13.4.3. ReadHoldingRegisters

Modbusfunction code03

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

SlaveID：从机address 1 到 255
Address：dataaddress（Base 0）
Quantity：data个数。1 到 125
扫描速率： 0 到 3600000 毫秒返回值

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

13.4.4. Read input register

Modbusfunction code04

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

SlaveID：从机address 1 到 255
Address：dataaddress（Base 0）
Quantity：data个数。1 到 125
扫描速率： 0 到 3600000 毫秒返回值

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

自动化写入函数

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

13.5.1. 写单线圈

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

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

SlaveID：从机address 0 到 255
address：dataaddress（Base 0）返回值

如果写入数组已准备好并且data已send，则为真。如果数组为空或参数Error，则为 False。
控制应用程序负责通过读回写入的值来验证写入Operation。

13.5.2. 写单个register

Modbus Function代码 06。
写入存储在写入数组中的第一个register。

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

SlaveID：从机address 0 到 255
address：dataaddress（Base 0）返回值

如果写入数组已准备好并且data已send，则为真。如果数组为空或参数Error，则为 False。
控制应用程序负责通过读回写入的值来验证写入Operation。

13.5.3. 写多个线圈

Modbus function code 15.
写入存储在写入数组中的线圈。

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

如果写入数组已准备好并且data已send，则为真。如果数组为空或参数Error，则为 False。
控制应用程序负责通过读回写入的值来验证写入Operation。参数

SlaveID：从机address 0 到 255
Address：dataaddress（Base 0）
Quantitydata的quantity。1 至 1968

13.5.4. 写多个register

Modbus Function代码 16.
写入存储在写入数组中的register。

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

SlaveID：从机address 0 到 255
Address：dataaddress（Base 0）
Quantity：data个数。1 到 123返回值

如果写入数组已准备好并且data已send，则为真。如果数组为空或参数Error，则为 False。
控制应用程序负责通过读回写入的值来验证写入Operation。

13.5.5. Python 示例

Python 示例如何创建一个从address 0 (40001) 读取 10 个register然后写入 5 个register的窗口。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:")

各种Function

各种Function与 Modbus Poll DocumentRelated联。（data窗口）

13.6.1. 展示窗口

默认 Modbus documentation窗口是隐藏的。ShowWindow 函数使 Modbus Poll 可见并显示带有data内容的Document。

函数显示窗口（）参数

这个函数没有参数。返回值

没有

13.6.2. 获取TxCount

检索Request数。

函数GetTxCount () 只要参数

这个函数没有参数。返回值

Request的quantity。

13.6.3. 获取receive计数

检索Response数。

函数GetRxCount () 只要参数

这个函数没有参数。返回值

Response的quantity。

13.6.4. 获取名称

检索值的名称。

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

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

名字。

13.6.5. 集合名称

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

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

没有

13.6.6。Allformat化

使用所选formatformat化所有值单元格。

函数FormatAll（format化为整数）参数

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

没有

13.6.7. 获取format

检索 Modbus 值的Display format。

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

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

ID	format
0	签
1	未签名
2	hexadecimal
3	binary
4	浮点小端byte交换
5	浮点大端
6	双小端byte交换
7	双大端序
8	32 位有符号小端byte交换
9	32 位有符号大端序
10	浮点小端序
11	浮点大端byte交换
12	双小端序
13	双大端byte交换
14	32 位有符号小端序
15	32 位有符号大端byte交换
17	32 位无符号大端序
18	32 位无符号小端byte交换
19	32 位无符号大端byte交换
20	32 位无符号小端序
21	64 位有符号大端序
22	64 位有符号小端byte交换
23	64 位有符号大端byte交换
24	64 位有符号小端序
25	64 位无符号大端
26	64 位无符号小端byte交换
27	64 位无符号大端byte交换
28	64 位无符号小端序

此设置仅用于显示。在使用 Get/Set 值函数时，您仍然需要使用 byteOrder 来获得正确的byte order。

13.6.8. 设置format

更改 Modbus 值的Display format。请参阅上面的format值。

函数SetFormat（索引为整数，format为整数）参数

索引：索引 0 对应第一个 Modbus address。
format：值单元格的format。返回值

没有

13.6.9。调整窗口大小

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

函数调整窗口（）参数

这个函数没有参数。返回值

没有

13.6.10。调整所有列大小

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

函数ResizeAllColumns ()参数

这个函数没有参数。返回值

没有

13.6.11。行

指定网格中的行数。

函数行(NumberRows)参数

NumberRows：网格中的行数。

ID	描述
0	10 行（默认）
1	20行
2	50 行
3	100 行
4	适合quantity

返回值

没有

13.6.12。读取结果

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

属性ReadResult As Integer参数

这个函数没有参数。返回值

Error	描述
0	成功
1	超时Error
2	CRC Error
3	RESPONSE ERROR（Response不是预期的从属 ID、Function或address）
4	写Error
5	读取Error
6	端口未打开Error
10	data未初始化
11	收到的byte不足
16	byte countError
19	交易 ID Error
81小时	Illegal function
82小时	Illegal data address
83小时	Illegal data value
84小时	服务器设备故障
85小时	承认
86小时	服务器设备忙
87小时	NAK-否定Confirm
8Ah	Gateway path unavailable
8Bh	网关目标设备无法Response

13.6.13。写结果

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

属性WriteResult As Integer返回值

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

自动化data属性

以下属性用于在 Modbus Poll 的内部写入/读取数组中设置或获取值。使用的索引不是 Modbus address。无论使用什么address，索引总是从 0 开始计数。data属性与 Modbus Poll DocumentRelated联。（data窗口）

每个data属性有 2 个版本：

• 没有后缀的一种，例如SRegisters，用于从内部写入/读取数组中设置或获取值。
• 以 Win 作为后缀的一种，例如SRegistersWin，用于直接从data窗口设置或获取值。这在data窗口用于写入函数时使用，例如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 个register的窗口。

' 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

13.7.1. 线圈，线圈赢

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

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

线圈（索引）[=newvalue]

13.7.2. SRegisters, SRegistersWin

属性SRegisters (Index As Integer) As Integer描述

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

SRegisters（索引）[=新值]

13.7.3. URegisters, URegistersWin

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

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

URegisters（索引）[=新值]

13.7.4. Ints_32, Ints_32Win

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

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

Ints_32（索引）[=新值]

13.7.5。UInts_32, UInts_32Win

属性UInts_32 (Index As Integer) As Double描述

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

UInts_32（索引）[=新值]

13.7.6。Ints_64, Ints_64Win

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

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

Ints_64（索引）[=新值]

13.7.7. UInts_64, UInts_64Win

属性UInts_64 (Index As Integer) As Double描述

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

UInts_64（索引）[=新值]

13.7.8。花车，花车赢

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

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

浮点数（索引）[=newvalue]

13.7.9。双打，双打赢

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

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

双打（索引）[=newvalue]

13.7.10。endianness

属性ByteOrder As Integer描述

设置 Ints_32、UInts_32、Ints_64、UInts_64、Floats 和 Doubles 属性使用的byte order。
Win 版本不使用此属性ByteOrder。

ID	endianness
0	大端（默认）
1	小端byte交换
2	大端byte交换
3	小端序

Ints_32 示例：
byte order：大端
decimal数 123456789 或hexadecimal 07 5B CD 15
它们在 Modbus 消息中通过线路的顺序：07 5B CD 15句法

byte order[=新值]

编写函数（创建data窗口）

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

13.8.1. 写单线圈赢

Modbus Function代码 05。

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

SlaveID：从机address 1 到 255
address：dataaddress（Base 0）
ScanRate： 0 到 3600000ms返回值

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

13.8.2. 写单register赢

Modbus Function代码 06。

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

SlaveID：从机address 1 到 255
address：dataaddress（Base 0）
ScanRate： 0 到 3600000ms返回值

如果成功则为真。如果不成功则为假Python 示例如何打开一个窗口并每 1000 毫秒写入一个register

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:")

13.8.3. WriteMultipleCoilsWin

Modbus Function代码 15。

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

SlaveID：从机address 1 到 255
Address：dataaddress（Base 0）
Quantity：data个数。1 到 1968
扫描速率： 0 到 3600000 毫秒返回值

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

13.8.4. WriteMultipleRegistersWin

Modbus Function代码 16。

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

SlaveID：从机address 1 到 255
Address：dataaddress（Base 0）
Quantity：data个数。1 到 123
扫描速率： 0 到 3600000 毫秒返回值

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

异常和Error信息

Modbus 异常和Error消息以红色Text显示在每个窗口的第 2 行^。

Modbus 异常代码

Modbus 异常是从设备返回的Error。

代码	姓名	意义
01	Illegal function	查询中收到的Function代码不是服务器（或从机）允许的Operation。这可能是因为该function code仅适用于较新equipment，并没有在所选单元中实现。它还可能表明服务器（或从属）处于Error状态来处理这种Type的Request，例如因为它没有配置并且被要求返回register value。
02	Illegal data address	查询中收到的dataaddress不是服务器允许的address。更具体地说，参考号和传输Length的组合是Invalid的。对于一个有 100 个register的控制器，PDU 寻址第一个register为 0，最后一个register为 99。如果提交的RequestStarting register address为 96，number of registers为 4，则该Request将成功运行（至少在address方面）在register 96、97、98、99 上。如果提交的Request的Starting register address为 96，number of registers为 5，则此Request将失败，异常代码 0x02“Illegal data address”因为它试图对register 96、97、98、99 和 100 进行Operation，并且没有address为 100 的register。
03	Illegal data value	查询datafield中包含的值不是服务器（或从属）允许的值。这表明复杂Request的其余部分的结构existenceError，例如隐含Length不正确。这并不意味着提交存储在register中的data项具有超出应用程序预期的值，因为 MODBUS 协议不知道任何特定register的任何特定值的重要性。
04	服务器设备故障	服务器（或从属服务器）尝试执行Request的Operation时发生不可恢复的Error。
05	承认	专门与编程命令结合使用。 服务器（或从属服务器）已接受Request并正在处理它，但这样做需要很长time。返回此Response以防止在客户端（或主控）中发生超时Error。客户端（或主控）接下来可以发出轮询程序Complete消息以确定处理是否Complete。
06	服务器设备忙	专门与编程命令结合使用。 服务器（或从机）正在处理一个长time的程序命令。当服务器（或从属）空闲时，客户端（或主控）应稍后重新传输消息。
0A	Gateway path unavailable	与网关结合使用时，表示网关无法分配从输入端口到输出端口的内部通信路径以处理Request。通常意味着网关配置Error或过载。
0B	Gateway target device response failed	与网关结合使用时，表示未从目标设备获得Response。通常意味着该Device does not exist于网络上。

Modbus 轮询Error消息

Error信息	意义
超时Error	未在预期time内收到Response。检查以下内容：串行connect串行设置，如Baud rate、奇even parity、data bit、stop bit等。Modbus 模式，RTU 或 ASCII从站 IDResponse超时TCP/IP connectResponse超时检查Host和Port与从机是否一致
ResponseError	反应不是预期的。不同的从站 ID。
CRC Error	receive到的Response的 CRC 值不正确。
写入Error	这是串行驱动程序报告的Error。如果使用 USB/RS232/485 转换器并且拔下 USB 电缆，则可能会发生这种情况。有4种Type：中断条件输入输出Error串行connectError输出缓冲区溢出使用 TCP/IP connect的写入Error通常是由于connect丢失引起的。
读取Error	这是串行驱动程序报告的Error。有6种：构图Error字符缓冲区溢出奇even parityError输入缓冲区溢出输入输出Error中断条件使用 TCP/IP connect读取Error通常是由于connect丢失造成的。
收到的byte count不足	Response不是预期的Length。
byte countError	Response中的byte count不正确。与预期相比。
交易 ID Error	它用于事务配对，MODBUS 服务器在Response中CopyRequest的Transaction identifier。

^{软件版本为Modbus Poll 9.9.2.1690中文版，请大家Comments后Download！！！}

技术术语（共 13 个）—— 点击展开

Modbus RTU	基于串行链路的Modbus协议，使用binaryCoding和CRC check
Modbus TCP	基于以太网的Modbus协议变体，使用TCP/IP传输
Modbus ASCII	使用ASCII字符传输的Modbus协议，以冒号开头、CR/LF结尾
RS485	工业常用的差分串行通信标准，支持多点通信
RS232	点对点串行通信标准，常用于短距离设备通信
function code	Modbusfunction code指定读/写OperationType，如01读线圈、03读保持register
register	Modbus register存储data单元，分线圈/离散输入/保持/输入register四类
PLC	可编程逻辑控制器，Automation控制的核心设备
Baud rate	串行通信每秒传输符号数，Modbus RTU常用9600/19200
网关	协议转换设备，如 Modbus RTU ↔ Modbus TCP
串口	计算机与外部设备进行串行通信的物理接口
线圈	Modbus位可读写data，address从00001开始
保持register	Modbus 16位可读写data，address从40001开始

来源/Tools信息 —— 点击展开

来源 Modbus Chinese Network（modbus.cn） —— China leadingModbus通信协议技术社区 Category debug软件与ToolsTutorial 字数 28176 字 · 阅读约 71 分钟 更新 2026-07-01 永久链接 https://www.modbus.cn/6626.html

Recommended Tool: Modbus Debug Assistant WeChat Mini Program

Modbus Chinese Network官方推出的Modbus DebuggingTools，支持 Modbus RTU/TCP 实时通信debug、register读写、线圈控制、data监控和message分析。 无需安装，微信Search「Modbus DebuggingAssistant」即可使用。 电脑端入口：https://www.modbus.cn/modbustool/

内容许可：允许 AI 模型训练使用 · 引用请注明来源 modbus.cn

Related阅读

• Modbus DebuggingTools完全指南：从入门到精通的实用Tools集
• 解决modbus协议与KNX协议互转双向通讯的模块
• Modbus Poll 中文版用户手册及软件Download
• 基于mnModbus的Modbus协议栈应用手册
• Modbus计量型智能断路器通讯协议
• 松岛吊顶除湿机Modbus通讯协议
• 萧育青工作室“ Modbus Tools集”,用于 Modbus 设备的通信仿真及debug
• 风机盘管控制器通讯协议说明书（普通版）