摩尔信使（MThings） 使用手册

关于本手册

本手册主要针对长念（上海）技术开发有限公司自主研发的 “摩尔信使 （MThings）”软件。

手册使用

在使用本产品前请仔细阅读本手册， 手册内容将不断更新、修正，但难免existence 与使用稍有不符或Error的情况 ，请及时在微信公众号 “ MThings 技术服务”上 留言给我们。

1 软件概述

摩尔信使（MThings）是一款基于 MODBUS 协议簇，面向工业控制现场 运维人员的上位机软件。

2 维护安装

2.1 Download

Downloadaddress： http://gulink.cn/download

2.2 安装

2.2.1 准备

个人电脑或服务器。

显示器分辨率：Recommended for use分辨率 1920*1080。

支持 Win7 及以上版本，兼容 32/64 位。

2.2.2 安装

1. Download软件包 MThings_Pack.exe；

2. 双击开始安装，根据步骤提示依次执行即可；

3. 双击图标即可启动软件。

如安装后，无法正常运行，请进入安装目录，双击“VC_redist.x86.exe” 文件后，再重新打开 MThings。

3 Function详述

3.1 基本概念

3.1.1 设备

设备即通信节点 ，MThings 中包含两类：模拟主机设备、模拟从机设备。

模拟主机设备：MThings 作为主机接入多个从机设备时，用户需要在软件 中给每一个从机设备创建一个对应的模拟主机，不同的模拟主机通过Device address 区分。

图 1 模拟主机设备示意

模拟从机设备：MThings 作为从机模拟data时，用户需要在软件中根据不 同的模拟从机address创建不同equipment。

3.1.2 data

MODBUS 标准中定义 4 种data块Type：

表 1 MODBUS data定义

data块	单位Length	访问Type	前导数	读function code
Coil status	1 Bit	RW	0	0X01
离散输入	1 Bit	RO	1	0X02
保持register	2 Bytes	RW	4	0X03
输入register	2 Bytes	RO	3	0X04

基于data块的单位Length ，可将 4 种data块分为两类： 位（BIT）data和寄存 器(REG)data， 结合读写属性，data块之间的关系如下图：

图 2 不同data块Type之间的关系

data是data块中的具体定义，不同data块中的data定义是相互独立的。 一 条data定义可以包含多个连续 BIT/REG dataaddress。

一条data的属性包括：隶属data块、data名称、dataaddress、data量、data Type（协议Type）、datacoefficient（浮点data被整形传输时涉及）、endianness（register data量为 1、2、4 时涉及）、字序（register data量为 2、4 时涉及）。

3.1.3 传输Type和呈现Type

MThings 提供友好的data可视化方法 ，支持以实际业务format展示message数 据。

传输Type即 MODBUS data协议中定义的Type，通常以整形居多 ，但往往 并非data实际format， 使用者为了Confirmdata的正确性需要重新计算。不够直观的 debugdata无疑严重影响调测效率和准确度。

MThings 支持用户指定每项data的传输Type和呈现Type，debug过程中，软 件自动按配置转换， 界面呈现的data将是data的真实内容。

例如，从机上报电压data 10.5V，register传输过程中data则为 0X0069， MThings 收到data后，将整形data乘以coefficient 0.1 ，界面呈现还原之后的data 10.5V。

图 3 设备data直观可视化效果示意

在录入data配置时， MThings 提供的参数包括传输Type、呈现Type、系 数、单位四项配置， 他们的含义分别是：

表 2 data呈现Related配置参数含义解释

呈现Type

register dataType 支持data量1、2、4

浮点型(FLOAT)

整形（decimal）（INT-DEC）

register dataType 支持data量1、2、4

整形（hexadecimal）（INT-HEX）

register dataType 支持data量2、4

byte流(BYTES)

register dataType 支持data量1~125

字符串(STRING)

BITdata type 支持data量1

位data(BIT)

参数	含义
传输Type	有符号整形（INT）、无符号整形（UINT）、浮点型 （FLOAT）、byte流（BYTES）、位data（BIT）
呈现Type	decimal整形（INT-DEC）、hexadecimal整形（INT-HEX）、浮点 型（FLOAT）、byte流（BYTES）、字符串（STRING）、纪元 秒（TIME）
coefficient	如呈现data type为浮点型且传输Type为整形，需配合coefficient使 用，软件自动将收到的data乘以coefficient转化为浮点data来显 示。
单位	辅助data含义描述， 直接呈现在界面

MThings 支持多种传输Type和呈现Type的转换，对应关系如下：

图 4 传输Type和呈现Type转换

传输Type 有符号整形（INT） 无符号整形(UINT) 浮点型(FLOAT) byte流(BYTES) 位data(BIT)

3.1.4 字序/endianness

通信debug中， endianness是个常见概念，比如本地endianness、网络endianness。 MODBUS 协议中同时existence字序概念。

endianness和字序都代表data在message中的存储机制，其分为两种：大端（Big- Endian）和小端（Little-Endian）。

MODBUS data帧中对关键field（例如register address） 都定义为大端byte 序，但是data部分在不同厂家的定义方式可能不同， 甚至同一厂家某一型号设 备中，对不同data的endianness定义也不统一。

基于 MODBUS message的byte排序，大端endianness即data高byte在前，低byte 在后，小端endianness相反。例如：

01 03 04 12 34 56 78 81 07 （读保持registerResponsemessage）

其中，回复dataLength 4Bytes, 如raw data即为 0X12345678，从message看， 其endianness即为大端，字序为大端。

但是， MODBUS register data在传输 4 bytes浮点型data时，有些设备厂家 同时给出字序要求， 并且明确声明字序为小端，即当raw data是 0X12345678 时，传输它的messagebyte流应该这样：

01 03 04 56 78 12 34 66 D5

MThings 为了支撑更好的适配不同厂家data协议的定义方式，对endianness和 字序做出如下处理：

每个data都可以独立配置其endianness和字序。

number of registers为 1、2、4 时，支持endianness可配置，涵盖 2、4、8 bytesdata。 register data量为 2、4 时，支持字序可配置，涵盖 4 bytes、 8 bytesdata。

其他register data量的data，字序、endianness默认为大端。

3.2 界面Function分区

图 5 界面Function分区示意

1. 主菜单：用于Switch“主Function页面”。

2. 设备列表：辅助“主菜单”，用户通过单击Device Name，可Switch当前激 活设备，指定新的“主Function页面”所属设备。

3. 辅助菜单：作为配置文件Operation、 通道管理、system参数、用户管理、授 权管理等Function入口。

4. 视图Switch：用于控制显示或隐藏“设备列表”和“message监控”窗口。

5. message监控：查阅和管理各链接的通信message。

6. 主Function页面：对应“主菜单”，提供主FunctionOperation界面。

3.3 配置文件管理

3.3.1 配置data内容

配置文件包含完整的 MThings 使用过程配置信息， 主要包括： 链接列 表、链接参数、设备列表、设备高级参数、data配置。

3.3.2 常用Operation

图 6 配置文件常用Operation

1. 新建：用于创建一个新的工程配置文件，首次使用可以不用新建配

置， MThings 退出前将提示配置存储。

2. 导入：通过导入FunctionSwitch工程配置文件。

3. 另存为：通过另存为OperationexportCopy当前工程配置，同时当前工程配置 文件Switch到新路径。

4. 保存：及时存盘工程配置文件。

当打开多个 MThings 软件并指向同一份配置文件时 ，配置data将会被重复 覆盖 ，最终的配置文件内容与最近一次保存Operation的内容一致。

禁止将配置文件放在软件包路径内 ，避免软件升级时被误Delete！

3.4 通道管理

设备
data配置			高级参数
	设备Type			Device address

MThings 软件支持以串口、TCP 链接、 UDP 单播的方式与目标机建立通 信， 这三种通信方式统称为通道。

通道是设备的关键属性， 通道确定设备通信方式，是Create device的前提。

图 7 通道与设备的逻辑关系

设备
data配置 设备Type	高级参数 Device address

通道
传输模式	通道Type

3.4.1 串口通道

图 8 串口通道Operation

通过辅助菜单中的“通道”进入通道管理页面，View当前 PC 中实际existence的 串口列表。 MThings 启动后，自动更新一次串口列表。如上图所示，串口Related Operation如下：

1. 选择过滤通道列表中所包含的链接Type ，界面默认为AllType ，Switch 为“串口通道”后， 列表中仅保留串口通道。

2. 当软件Open后 ，插入 USB 转 RS485 模块 ，单击“refresh”，可将新串口 添加至列表中，如未出现新串口，请检查模块驱动。当链接列表中出 现Invalid串口（串口does not exist且无挂靠设备）时， 单击“refresh”，可将将这 些串口从data配置中Remove。

3. 如需修改串口详细参数 ，单击“配置”button进入“Serial port parameters配置”页 面。

4. View通道状态 ，通道状态含义如下：已Close、Connected、故障。

5. 手动打开或Close the serial port。添加设备时，无需手动Open。手动模式可用于

批量控制链接上挂靠的所有设备 ，使其启动或停止。

6. Serial port parameters配置页面。

表 3 串口通道状态定义

通道状态	含义
已Close	软件未Enable该串口或被手动Close
Connected	软件成功打开并初始化串口
故障	软件Open the serial port失败，原因可能是串口被其它软件占用或设 置的Serial port parameters不合法

表 4 串口链接参数定义

参数	含义
通道名称	Operationsystem分配信息， 不可修改
传输模式	用于指定当前串口上运行的传输协议Type，可选择 “ MODBUS-RTU”或“MODBUS-ASCII”
字符Type	当传输模式选择“MODBUS-ASCII”时， 通过该参数指定协议 字符使用大写或小写，默认为标准协议要求的大写方式
Baud rate	支持 1200、2400、4800、9600、19200、38400、57600、 115200bps ，如设置为其它numerical value将导致串口打开失败
校验方式	指定串口byte中data校验方式
data bit	指定串口byte count据中data bit个数。如 MODBUS-ASCII 协议中 要求data bit为 7Bit 时，请修改该参数
stop bit	指定串口byte中stop bitLength
流控Type	默认无流控 ，根据实际应用按需修改

如使用虚拟串口 ，主从设备软件应使用配对的串口

3.4.2 网络通道

图 9 网络通道Operation

通过辅助菜单中的“通道”进入通道管理页面，可View网络通道列表。首次 使用时，无网络通道，需用户根据需要创建。如上图所示，网络RelatedOperation如

下：

1. 选择过滤通道列表中所包含的通道Type ，界面默认为AllType ，Switch 为“网络通道”后， 列表中仅保留网络通道。

2. 单击“新增网络链接”button，创建一路新网络通道。

3. 单击“Remove网络链接”，Delete通道列表中已被勾选的网络通道，该Operation 将同步至工程配置文件。

4. 单击“配置”button， 修改网络通道参数。

5. View通道状态，网络通道状态包括：已Close、Connected、connect中、故 障。

6. 手动建立通道或Close通道。添加设备时，无需手动Open。手动模式可 用于批量控制通道上挂靠的所有设备 ，使其启动或停止。

7. 网络通道参数配置页面。

表 5 网络通道状态定义

通道状态	含义
已Close	软件未Enable该链接 链接被对端断开 链接被手动Close
Connected	网络通道已成功建链
connect中	TCP 客户端：正在connect服务端 TCP 服务器：正在等待接入客户端
故障	TCP 服务端：本地端口被占用 UDP 单播： 本地端口被占用

表 6 网络通道参数定义

参数	含义
通道名称	MThings 统一分配，不可修改
链接模式	选择 MThings 在网络层的链接角色，可选择 TCP 客户端、 TCP 服务端、 UDP 单播
重新建链周 期（秒）	当链接模式选择为“TCP 客户端”，通过设置重新建链周期， 可指示 MThings 按照指定time间隔重新建链，通过这种方式 可以模拟短链接。默认周期为 0，代表长链接。
链接空闲保	当链接模式选择为“TCP 客户端”或“TCP 服务端”时，链
持time	接建立后，如果在参数指定time内无任何data交互，
（秒）	MThings 将主动Close链接。
传输模式	用于指定当前链接上运行的传输协议Type，可选择 “ MODBUS-RTU”、“MODBUS-ASCII”、“MODBUS-TCP

（同步）”、“MODBUS-TCP （异步）”

字符Type

当传输模式选择“MODBUS-ASCII”时， 通过该参数指定协 议字符使用大写或小写，默认为标准协议要求的大写方式。

当链接模式选择为“TCP 客户端”或“UDP 单播”，该参数用 户指定本地发起 IP，可不配置， MThings 可自动择优。

本地 IP

当链接模式选择为“TCP 服务端”或“UDP 单播”，需指定绑 定本地端口。

本地端口

当链接模式选择为“TCP 客户端”，该参数为只读data，用于 呈现Connected状态下的本地发起端口号。

当链接模式选择为“TCP 客户端”，该参数用于指定服务端的 域名或 IP address。

目标域名/IP

当链接模式选择为“UDP 单播”，该参数用于指定datasend对 象的 IP address。

当链接模式选择为“TCP 客户端”，该参数用于指定对端（服 务端）绑定端口号。

目标端口

当链接模式选择为“UDP 单播”，该参数用于指定datasend对 象的receive端口号。

当链接模式选择为“TCP 服务端”，该参数用于指定允许接入 当前服务端的客户端 IP，其它 IP address发起的connectRequest将被过 滤丢弃。 如不需过滤Function，该参数请设置为“ –”或Clear。

客户端 IP

源端口

当链接模式选择为“TCP 服务端”，该参数为只读data，用于 呈现Connected的客户端发起端口号。

当传输模式选择为“MODBUS-TCP （异步）”，该参数可控制 异步并发规模，调节并发Request个数

最大并发请 求数

图 10 TCP 客户端链接应用方法

TCP服务端

(192.168.0.20, 502)

MThings 本机address： 192.168.0.10

TCP客户端-1 目标IP: 192.168.0.20 目标端口： 502

TCP客户端-2 目标IP: 192.168.0.20 目标端口： 502

TCP客户端-3 目标IP: 192.168.0.30 目标端口： 502

TCP服务端

(192.168.0.30, 502)

图 11 TCP 服务端链接应用方法

本机： 192.168.0.20

TCP客户端- 1 目标address： 192.168.0.10 目标端口： 502

TCP客户端-2 目标address： 192.168.0.10 目标端口： 502

本机： 192.168.0.30

TCP客户端-2 目标address： 192.168.0.10 目标端口： 503

MThings 本机address： 192.168.0.10

TCP服务端-1 本地端口： 502 客户端IP: 192.168.0.20

TCP服务端-2 本地端口： 502 客户端IP: 192.168.0.20

TCP服务端-3 本地端口： 502 客户端IP: 192.168.0.30

TCP服务端-4 本地端口： 503 客户端IP: 192.168.0.20

TCP客户端-1 目标address： 192.168.0.10 目标端口： 502

图 12 UDP 单播链接应用方法

本机： 192.168.0.20

UDP单播 -1 本地端口： 502 目标IP: 192.168.0.10 目标端口： 502

本机： 192.168.0.30

UDP单播 – 1 本地端口： 502 目标IP: 192.168.0.10 目标端口： 503

MThings 本机address： 192.168.0.10

UDP单播 -1 本地端口：502 目标IP: 192.168.0.20 目标端口：502

UDP单播 -2 本地端口：503 目标IP: 192.168.0.30 目标端口：502

3.5 system参数

system参数页面提供 MThings 软件全局控制参数， 用户可运行时修改并及时 生效，参numerical value将保existence本地。

图 13 system参数页面

表 7 system参数定义

参数	含义
自启动	Functionswitch，用于控制 MThings 是否随Operationsystem自 启动，默认Close。
历史data存储间隔 （秒）	历史dataFunction辅助参数，用于控制历史refresh存储间 隔time。
历史data抬头	历史dataFunction辅助参数，用户配置该参数后，抬头 信息将随历史data报表一同打印输出。
data页面refresh	Functionswitch， 为了避免 CPU 算力资源浪费， 当用户 Enable“system”页面进行data阅览后，可通过该开 关，Close所有设备“data”页面的data更新，但其 并不影响data的receive、Parse、存储。
运行模式	支持桌面或者 PAD 模式，让软件在不同的终端运 行具备更好的展示效果。

3.6 用户管理

用户管理页面提供两种用户Type： 管理员、终端用户 。管理员可以执行 MThings 所提供的所有Function， 终端用户仅允许Operation部分Function， 不显示调测Function， 禁止其修改设备data、告警、system配置等。

表 8 用户权限分配

页面	管理员	终端用户
system页面	✔	✔
历史data页面	✔	✔
告警data页面	✔	✔
data页面	✔	✔
Customization页面	✔	✘
统计页面	✔	✘
辅助页面	✔	✘
关于页面	✔	✔

管理员默认为无密码。MThings 首次使用， 默认为无密码管理员，支持管理 员修改自身密码。一旦管理员设置了非空密码， MThings 重启后以终端用户Login。 用户需自行输入管理员密码Switch为管理员用户。

图 14 用户管理

3.7 授权管理

针对 MThings 中的商用（付费）Function， 用户需要获得授权后方能使用。用户 购买授权前，需进入授权管理页面生成机器识别码。获得授权证书后，进入授权 管理页面导入授权证书，激活商用Function。

授权证书仅限一台运行 PC 使用，如需扩展多台 PC ，应提前购买多份。

图 15 授权管理

1. 单击后，自动生成唯一机器码， 可用于购买授权证书；

2. 单击后，跳转至授权证书付款页面；

3. 获得授权证书后，单击此button导入授权证书。

重装system、磁盘更换等行为可能使得system关键标识信息变化， 导致授权失效， 需重新购买授权。 system关键标识信息无法正常获取的运行Operationsystem将无法生成机器码，进而无 法获得授权。

3.8 设备管理

设备是通信debug目标设备的本地镜像或服务对象，设备是进行一切

MThings debug工作的基础。通过这种设备集成方法， MThings 才具备了多设 备、多协议、多通道的debug能力。

3.8.1 添加设备

图 16 添加设备示意

1. 添加设备入口；

2. 选择添加设备所在的通道；

3. 选择添加设备equipmentType；

4. 选择添加设备的address；

5. 点击“添加”后所配置equipment呈现在【06】。

设备（节点）address范围为 0~255，starting address应小于等于Endaddress。通过设 置starting address和Endaddress，支持一次添加多A device，如starting address等于Endaddress代 表仅添加一台设备。

如待添加的Device address分散在多个区间 ，可以多次点击添加。

6. 单击“添加”button。

7. 新增设备将出现在设备列表中。

如新增Device address在设备列表中已existence，不会重复创建。 如链接中已existence模拟主机 ，不允许再添加模拟从机 ，反之亦然。

3.8.2 Remove设备

图 17 Remove设备示意

1. 勾选需要Removeequipment。

2. 单击“Remove”button。

Remove设备将Delete设备下的所有data配置信息， 请谨慎Operation！ 如设备被误Remove， 请重新load工程配置，切记不要保存当前配置。

3.8.3 设备信息View

图 18 设备信息View示意

1. 单击“>>”button，设备列表自动扩展页面，显示设备关键信息：设 备Type、 设备 ID、所属通道、Device address。

表 9 Device Name状态含义

Device Name状态	含义
蓝色背景 [M]COM1-001	当前设备被激活
字体红色 [M]COM1-001	设备停止运行，所属链接断开或设 备被禁用

以上状态可重叠出现。

图 19 设备状态标识含义解释

厂厂

添加设备后 ，MThings 分配默认名称 ，其format说明如下：

图 20 默认Device Nameformat含义

[M]COM1-001

[设备Type]： 链接名称 Device address

M:模拟主机

S:模拟从机

3.8.4 设备禁用

如需设备临时停止工作 ，可禁用设备，指示设备停止所有业务和通信。设 备禁用Operation常用于暂停模拟从机，可模拟设备掉线。

图 21 设备禁用示意

1. 勾选需要禁用equipment，双击表头“Serial number”，可全选。

2. 单击“禁止”button。设备禁用成功后，Device Name字体颜色变为红色。

设备禁用Operation仅用作临时措施 ，如设备禁用期间 ，其所属链接出现断链并重 新恢复 ，设备将自动恢复。

3.8.5 设备恢复

图 22 设备恢复Operation示意

1. 勾选需要恢复equipment，双击表头“Serial number”，可全选。

2. 单击“恢复”button。设备恢复成功后，Device Name字体颜色恢复为黑 色。

如需恢复equipment所属链接已Close ，单击“恢复”后， Device Name维持为红色， 其所属链接状态恢复为“Connected”后，设备也将自动恢复。

3.8.6 设备属性修改

针对Created devices ，支持修改设备关键属性 ，包括：Device Name、所属链 接、Device address。

通过修改Device Name ，用户可根据Customization需求命名更佳的标记。

通过修改所属链接、Device address ，用户可快速适配debug环境的变化。用户可 提前在本地的任意链接上进行设备添加、data配置和debug，现场debug时，则可 快速Switch为实际工作链接。

图 23 设备属性修改示意

1. 双击需要修改equipment行。

2. 弹出“变更设备关键信息”页面，可在numerical value列修改设备关键属性信 息。

3. 如需将变更后的所属链接信息同步至其它设备 ，单击“同步链接至其 它设备”button，选择需要Copy新链接信息equipment，软件将自动修改指 定设备的所属链接。

所属链接和Device address变更后，如Device Name依旧为软件分配的默认名称，软 件将自动替换默认名称中的链接和addressfield，无需手动修改Device Name。

例如，设备原名称为：[M]COM1-001，如所属链接修改为 COM2 ，address 修改为 2，设备属性修改Complete后，Device Name将自动变更为[M]COM2-002。

Device Name不允许为空，同时要保证全局唯一，否则将提示修改失败。 设置的新所属链接如已有其他设备Type，将提示修改失败。 设置的新Device address如在所属链接上已existence，将提示修改失败。

已添加设备不支持修改设备Type。 如在添加设备时，Type选择Error，同时已经Complete大量data配置， 建议先export 设备下的data模板， DeleteError设备，重新添加正确Typeequipment， 并导入data 模板。

3.9 设备data配置

设备data配置就是将 MODBUS data协议定义转换为 MThings 配置。完 成设备data配置后， 无需手动组包和data换算，通过简单的buttonOperation即可以快 速发起轮询、批量读写、单个读写。 MThings 支持直观可视化展示协议data信 息，可快速提升调测效率。

设备data配置前，请于左侧设备列表Confirm是否选择了正确的待配置设备。

3.9.1 新增data配置

方法一：

图 24 新增data配置示意

1. 单击“data”菜单。

2. 单击Device Name ，选择需要data配置equipment。

3. 单击“新增”button。

4. 弹出“新增data配置”页面，默认每次新增一条data，startdataaddress 为当前配置中最后一行dataaddress+data量。用户可修改新增的配置条 数、区块和startdataaddress。

该方法新增的data将直接添加至表尾。

方法二：

可通过拖拽表格中任一已有data配置的“ 区块”单元格触发新增 ，拖拽的 start行 ，即为模板行，新配置将插入至拖拽End位置。

3.9.2 Deletedata配置

图 25 Deletedata配置示意

1. 单击 ID 列， 选中需要Delete的data配置，双击表头“ID”可全选或取 消全选。

2. 单击“Delete”button。

Deletedata并单击“保存”配置文件后，将丢失这些data配置信息，请谨慎操 作！

3.9.3 Edit配置项

表 10 配置项Operation说明

配置项	用途&配置方法
ID	不可Edit ，软件按序分配。
名称	data名称 ，可任意定义 ，不可为空。
numerical value	不可Edit ，Operation态中 ，双击可触发单次读写Operation。
指令	双击后开始Edit，输入待下发的写指令data，如无背景色，代 表data不支持下发写指令。
写	Operation态时， 双击触发写指令下发。
单位	data单位 ，可任意定义。
范围	data值范围 ，用于辅助debug ，可任意定义 ，不参与校验过程。
区块	双击单元格后选择修改data area块Type ，区块定义参考 MODBUS 标准协议 ，修改区块后 ，可能导致其他field强制修 改。
address	当前data项的starting address ，无需前导数。 范围：0~65535。 注：结合高级参数中的address偏移，该address为协议（界面）地 址，而非传输address， 如address偏移为-1 ，则该addressminimum必须大 于 0，否则address不合法。
quantity	当前data项连续占用的dataaddress个数。 如data项为register data，单位为字（2 bytes）。 如data项为 BIT data，quantity强制为 1，不可修改。 不得小于 1。 如data项为保持register，不得大于 123。

如data项为输入register ，不得大于 125。

用于register data，如data项仅占用register其中的部分位，该项 配置则用于指定占用位的start偏移。如data不涉及register部分 位，该项配置使用默认值即可。

注：位偏移基于已Complete的endianness/字序转换data， 由data低位 开始 ，最低位为 0。

位偏移

用于register data，如data项仅占用register其中的部分位，该项 配置用于指定占用的总位数。如data不涉及register部分位，该 项配置使用默认值即可。

register的位数默认值 = dataquantity * 16。

位数

BIT data的位数固定为 1。

位数可配置范围 1~64Bit。

用于register data ，如传输Type为整形 ，呈现Type为浮点型时， 则：呈现data = 协议整形data * coefficient + 偏移。

coefficient

其它Type组合时，coefficient固定为 1。

coefficient推荐设置范围：±(0.000001~1)。

偏移

用于register data ，如传输Type为整形 ，呈现Type为浮点型时， 则：呈现data = 协议整形data * coefficient + 偏移。

模拟主机支持该配置项。勾选后 ，该项data参与批量读，否则 发起批量读Request时， 忽略该data项。

批量读

模拟主机支持该配置项。勾选后 ，该项data参与批量写，否则 发起批量写Request时， 忽略该data项。Coil status和保持register数 据可勾选，不支持只读data。

批量写

勾选后 ，data项添加至曲线监控页面 ，以曲线形式持续记录数 值。 data的呈现Type为byte流(BYTES)、字符串(STRING)、纪 元秒(TIME)时 ，不支持添加为曲线。

曲线

存储

勾选后，当前data值将周期存储，可以在历史data中View。

注： MThings 重启后生效。

传输Type	双击单元格后选择修改 MODBUS data协议中定义的data类 型，请Confirm并与协议保持一致。详细说明请参考data章节。
呈现Type	双击单元格后选择修改软件界面呈现的data type，可实现更友 好的data可视化，与传输Typeexistence约束关联，详细说明请参考 data章节。
decimal places	如呈现Type位浮点数，该参数生效，否则强制为 0。 用于控制numerical value的小数点个数，可设置范围 0~9。
endianness	用于register data ，如dataquantity为 1、2、4 时，需要指定byte 序。请参考 MODBUS data协议要求，如无特殊要求，选择大 端。 其它dataLength时 ，endianness默认为大端。
字序	用于register data ，如dataquantity为 2、4 时，需要指定字序。请 参考 MODBUS data协议要求， 如无特殊要求，选择大端。 其它dataLength时 ，字序默认为大端。
间隔time	用于控制读写Request之间的间隔time。 模拟主机模式下，该time生效于收到Response（超时）之后。 模拟从机模式下 ，该time生效于Request与Response之间。 如data项与其它data项合并为一个Request/Response，间隔time取其 中maximum。 注：当模拟主机处于 MODBUS-TCP 异步传输模式 ，该参数 不生效。
超时time	用于模拟主机 ，指示data读写Request的最大允许Response延时 ，超过 该time则判为超时 ，继续下一个Request。

如data项与其它data项合并为一个Request，超时time取其中的最 大值。

重发次数

用于模拟主机，指示当data读写Request超时后，是否需要重发及 其重发次数。默认设置为 0 时， 代表不重发。

图 26 模拟主机的超时time和间隔time示意

图 27 模拟从机的间隔time示意

图 28 位偏移&位数示例

最高位(Bit：63)

最低位(Bit：0)

4 Reg (8 Bytes)

1 Reg

300001 300002 300003 300004

位偏移：11 位数：13

data配置项中如果勾选过多曲线，同时被勾选dataexistence长time高频refresh，势 必导致电脑内存持续增加，建议谨慎关联过多data曲线。

3.9.4 批量Edit配置

如需快速Editdata配置的“名称”、“单位”、“address”、“quantity”、“位偏移”、 “位数”、“coefficient”、“偏移”、“范围”，MThings 支持用户拷贝多行 Excel data， 并粘贴至data配置表指定位置。

图 29 批量填充配置示例

3.9.5 标记data背景色

图 30 标记data背景色示意

1. 长按需要标记背景色的data“名称”单元格，将会弹出“设置data名 称背景色”页面。

2. 单击“选择颜色”button，选择Customization背景色。

3. 单击“重置颜色”button，可将背景还原为初始颜色。

4. 单击“同步至其它data”button， 可将选择的背景色Copy给其它data 行。

3.9.6 手动data排序

可通过拖拽data的“address”单元格，将data配置行更换位置。

支持向下或向上任意位置拖拽。 data配置行将添加至拖拽停止行的上一行。 如需拖拽至尾行 ，应将配置行拖拽至表格空白处。

3.9.7 一键data排序

图 31 一键data排序示意

1. 双击“排序”button， 即Complete一键排序Function。

一键排序Rules：

Sort data区块，依次为：Coil status、离散输入、 保持register、输入寄 存器。

相同data area块内，以“datastarting address”为参考按由小及大排序。

datastarting address相同时，以“位偏移”为参考由小及大排序。

位偏移相同时，以“位数”为参考由小及大排序。

3.9.8 高级参数设置

软件提供设备高级参数配置，用于控制设备读写Related的公共Function。

图 32 设备高级参数设置示意

1. 点击 “高级参数配置”图标进入页面。

2. “高级参数配置”页面中修改相应参数。

3. 单击“同步至其它设备”，可将当前设备的所有高级参数拷贝至被选 择equipment。

4. 单击“确定”button， Complete并保存高级参数。

表 11 设备data页面状态定义

参数	用途&配置方法
address偏移	messagedataaddress = 协议 （界面）dataaddress+address偏移。 默认为 0 ，修改时 ，请仔细Confirm协议要求。

用于指定dataaddressDisplay format ，可选择“decimal”或“十 六进制”。当选择“hexadecimal”时，addressformat为

address显示模式

XXXXH ，Edithexadecimaladdress时 ，可不携带后缀 H ，软件 将自动补齐。

为适配非标协议 ，通过该参数可指定 RTU message中 CRC endianness ，默认“小端”。

CRC endianness

（RTU 模式生 效）

线圈/离散量位序

为适配非标协议 ，通过该参数可指定线圈/离散量读写过 程中连续位的打包方式 ，默认“高位在左”。

仅用于模拟主机，该参数指示设备在进行批量读写Request 时对多个相邻address的data如何组包。

默认为“逐条”，即每行data的读写单独一条Request。

“按address大小排序”即为自动组包，并按register address由 小及大进行连续address组包。

“按列表顺序排序”即为自动组包，并按界面表格中的 顺序进行连续address组包。

读data组包方式

BIT data最大允许 间隔

仅用于模拟主机，该参数指示在进行读 BIT dataRequest组 包时，允许的最大address间隔。

BIT data批量写时 ，不允许existence任何address间隔。

仅用于模拟主机，该参数指示在进行读register dataRequest 组包时，允许的最大address间隔。

REG data批量写时 ，不允许existence任何address间隔。

REG data最大允 许间隔

单register写Function

仅用于模拟主机 ，适配非标设备的特殊要求。

默认按照标准要求使用 0X06 function codeRequest单个保持寄存 器的写Request。

单线圈写function code 仅用于模拟主机 ，适配非标设备的特殊要求。

默认按照标准要求使用 0X05 function codeRequest单个Coil status 的写Request。
广播设备	仅用于模拟主机，用于指示当前设备是否为广播设备， 如选择是，该设备下发的所有Request将不等待Responsemessage。 注：仅适用于所属链接是串口的模拟主机。
广播address-1	仅用于模拟从机，用于指示广播address，默认为 0。 注：当模拟从机的传输模式是 MODBUS-TCP （同步或 异步），广播address代表所有从机都需要处理该addressRequest， 但不需要回复（由广播address设备回复）。 注：如 MODBUS-TCP 传输模式下需要使用 0 address，且 不涉及广播需求，建议将参数修改为其它address。
广播address-2	同上
启动后立即批量 读	仅用于模拟主机，用于指示当设备链接建立或设备恢复 运行后，是否启动一次或循环批量读Operation
启动后立即批量 写	仅用于模拟主机，用于指示当设备链接建立或设备恢复 运行后，是否启动一次或循环批量写Operation

设备高级参数可以同步拷贝至其它设备。

3.9.9 拷贝data配置

当多A device遵循相同 MODBUS data协议时 ，如已Complete其中一台设备的数 据配置 ，可通过拷贝Operation将当前设备data配置完整的拷贝给其它选定设备。

图 33 拷贝data配置示意

1. 单击“将配置Copy给其它设备”图标button，进入“选择设备”页面。 2. 如设备较多，可单击“Type筛选”button，挑选模拟主机或模拟从机。

3. 如设备较多 ，可单击“链接筛选”button，筛选部分链接下equipment。

4. 选择需要拷贝data配置equipment。

模拟主机和模拟从机之间可以相互拷贝data配置。

拷贝data配置将覆盖目标设备的已有配置 ，请谨慎Operation！

3.9.10 制作并exportdata模板

MODBUS 中的data配置工作量巨大，为了便于将data配置进行传递和共 享， MThings 支持exportdata模板Function， 将其独立于具体的debug环境、链接、设 备等差异化因素。被共享者可通过data模板快速搭建起自己的debug环境，不需 要再次重新配置data。

图 34 制作并exportdata模板示意

1. 单击“export”button， 进入“export设备data配置”页面。

2. 填写data模板所必要的附加信息。

图 35 export的data模板文件示意

3.9.11 导入data模板

图 36 导入data模板示意

1. 单击“导入”button， 进入“选择设备配置模板文件”页面。

2. 选择data模板文件。

模拟主机和模拟从机之间可以相互导入另一方的data模板，但是建议Operation之 前谨慎Confirm两种设备Type的data配置之间的差异。

3.10 模拟主机设备dataOperation

3.10.1 单次读data

图 37 单次读dataOperation示意

1. 双击需要读取data行的“numerical value”单元格。

2. 双击“numerical value”表头， 可实现单次批量读所有行data。

当设备由于被禁用或链接已Close ，将无法成功启动单次读。 单次Operation并非仅面向单register ，如data由多个连续register组成 ，也支持单次 Operation。

3.10.2 批量读（轮询） data

图 38 批量读dataOperation示意

1. Confirm需要批量读data的勾选范围。

2. 设备列表中勾选所需进行批量读equipment。

3. 点击“启动轮询”button即Open轮询，再次点击buttonCancel轮询。

如希望设备启动后立即开始批量读，可修改设备高级参数中的“启动后立即 批量读”。 如需改变批量读的data范围，重新勾选“批量读”的data组合。 当设备由于被禁用或链接已Close ，将无法成功启动批量读。 设备“批量读”Related的参数变化后，需要重启轮询方可生效。

3.10.3 单次写data

图 39 单次写dataOperation示意

1. 双击触发Edit“指令”单元格， 输入下发data的目标值。

2. 双击写button ，立刻下发写data指令。

如numerical value修改是为批量写data而准备 ，可忽略步骤 2。

仅Coil status和保持register支持该Operation。 当设备由于被禁用或链接已Close ，将无法成功启动单次写。 单次Operation并非指单register ，如data由多个连续register组成 ，同样支持单次操 作。

3.10.4 批量写data

图 40 批量写Operation示意

1. Confirm需要批量写data的勾选范围。

2. 设备列表中勾选所需进行批量写equipment。

3. 点击“启动轮写”button即Open轮询，再次点击buttonCancel轮写。

仅Coil status和保持register支持该Operation。 如希望设备启动立即开始批量写，可修改设备高级参数中的“启动后立即批 量写”。 当设备由于被禁用或链接已Close ，将无法成功启动批量写。 设备“批量写”Related参数变化后，需重启“批量写”方可生效。

3.10.5 Viewdata曲线

如data配置项中勾选了曲线，且data已进行读Operation并持续一段time，可以 进入“data曲线展示器”中Viewdatanumerical value的变化的情况。

图 41 Viewdata曲线示意

1. Confirmdata曲线的勾选范围。

2. 单击“曲线”button， 打开“data曲线展示器”。

3. Viewdata曲线。

3.10.6 Parsemessage

为了便于分析读data的Responsemessage和写data的Requestmessage ，MThings 支持基于 现有设备data配置， 将Original message中的 BIT、register data映射到data表中， 省去用 户逐byte分析计算工作，可以直观View传输data内容。

图 42 ParsemessageOperation示意

1. 单击“Parsemessage”button，打开Parsemessage输入页面。

2. 如Original message为读dataResponsemessage ，需输入startdataaddress （message传输地 址，以Request帧内容为准）， 否则可不输入。

3. 输入Original message PDU ，去除原message中的头部分 ，从function code开始。

4. 单击“提交”button。

5. ViewParse后的data。

图 43 PDU 定义

3.10.7 data查找

当data配置行数较多 ，用户需要快速定位某个data行时 ，可通过Searchdata 名称 ，将表格快速滚动到指定位置。

图 44 data查找Operation示意

1. 输入待查找data名称中的部分关键字 （区分大小写）。

2. 单击Searchbutton。

3. 如有匹配项 ，表格将auto-scroll到相应位置 ，data名称字体标红。

由于每行信息较多，信息View时需要横向拖动滚动条 ，为了方便信息View， 可加高data行 ，Operation如下：

图 45 加宽行高Operation示意

1. 单击“名称”列单元格，当前行加高。

2. 单击“ID”列单元格，Cancel当前行高。

如existence多个匹配项 ，用户可多次单击Searchbutton ，查找Function将持续遍历表格其 它行 ，并标识出匹配项目。 Search范围仅包含“名称”列。

3.10.8 data筛选

data页面提供了多种信息筛选方法 ，便于用户更快更好的聚焦关键信息。

图 46 data筛选示意图

1. 单击“筛选区块”button，可隐藏/显示指定的data块Type。

2. 单击“筛选行”button，可隐藏/显示指定的表格行。

3. 单击“筛选列”button，可隐藏/显示指定的表格列。

筛选区块Operation仅为临时Operation ，重启软件后 ，所有区块将重新显示。 筛选行和筛选列Operation将存储配置文件 ，重启软件后将保持上一次选择的显示 /隐藏状态。

3.11 模拟从机设备dataOperation

模拟从机设备data的回复过程不需要手动触发 ，当receive到主机Request后 ，软 件自动组包回复。模拟从机也支持data曲线、Parsemessage，Operation方法参考上一章 节。

图 47 预置模拟data方法示意

1. 双击需要模拟data的“numerical value”单元格，打开“选择模拟data方法”页 面。

2. 配置模拟data方法前 ，参考不同的曲线说明。

3. 配置模拟data方法Complete后 ，参考示例曲线。

4. 单击“应用”生效模拟data方法。

可将一行“numerical value”单元格拖拽至另一行“numerical value”单元格处，实现模拟data配 置快速拷贝。

表 12 模拟data方法参数定义

参数	用途&配置方法
策略	定义模拟方法 ，默认为fixed value
refresh间隔time(ms)	numerical value更新的间隔time ，间隔time内 ，numerical value维持不 变。
time轴起点	定义曲线time轴的原点位置。
随机区间上下限	基于已有的曲线numerical value ，当定义effective随机区间后 ，叠 加范围内的随机数。如上下限相同，代表无随机。
极大值/极小值	基于已有的曲线numerical value ，当定义effective极值范围 ，曲线 numerical value将被约束在此范围 ，一般可用于曲线削峰填 谷。如极大值极小值相同，代表Close该Function。
表 13 从机register data策略配置
策略	用途&配置方法
fixed value/直线/parabola	参考软件界面中说明
/sine curve/square wave
预置data	每条data之间通过换行符作为间隔； 支持从 excel 中整列data拷贝至data窗口； 当refresh间隔设置为 0 时， 按行循环回复主机 的Request； 当软件重启或者重新Open轮读时，data回复 也会重置。
关联模式	关联其他模拟主机的任意data， 用于整合关键信息 转发至北向设备。

3.12 data曲线展示器

data曲线展示器是多data曲线的容器 ，服务于多个重要Function区。一条曲线 即为一个图例，展示器提供图例Customization、data统计、exportFunction。

3.12.1 曲线View

图 48 曲线View示意

曲线视图中包含data曲线（图例）列表、图例显示区。左侧图例列表中包 含处于显示状态的图例 ，背景色与曲线颜色一致。图例显示可同时显示多个图 例。不同图例默认关联于左 Y 轴 ，也可通过配置将部分图例关联至右 Y 轴。

ViewOperation方法如下：

1. 用户可在图例显示区任意位置 ，长按鼠标左键 ，任意方向拖动图例显 示区域。

2. 用户可在图例显示区任意位置，通过鼠标滚轮控制图例显示区域放大 或缩小。

3. 用户可双击图例显示区任意位置 ，重置显示区域范围为初始状态。

4. 用户可单击曲线中任意位置，显示曲线中data点的详细信息。

3.12.2 维护图例

图 49 维护图例示意

1. 单击“维护图例”button，打开图例Edit页面。

2. 单击勾选可控制曲线图例是否显示。

3. 双击可修改曲线图例的当前颜色。

4. 双击Edit可修改曲线图例的线宽。

5. 单击勾选可将图例关联至右 Y 轴。

6. 不可Edit ，曲线data统计结果 ，显示为maximum。

7. 不可Edit ，曲线data统计结果 ，显示为minimum。

8. 不可Edit ，曲线data统计结果 ，显示为平均值。

3.12.3 坐标轴管理

data曲线展示器支持多种模式Viewdata曲线，包括：普通模式、固定模式、 示波器模式。

普通模式中， time轴Length固定，Endtime固定为当前time，开始time根据“最 大持续time”参数自动向前倒推；

固定模式中，time轴范围由用户指定后保持不变；

示波器模式中，time轴Length由用户指定，Endtime固定为当前time。

图 50 坐标轴参数

表 14 坐标轴参数定义

参数	用途&配置方法
更新间隔(ms)	控制曲线展示器datarefresh间隔time。
time轴模式	Switchtime轴展示模式。
最大持续time（小时）	控制曲线中所有data最长保留time，超过该time 后，曲线data将被自动Remove。
窗口时长（秒）	time轴“示波器”模式下生效， 指定time轴可显示 的Length，该值应小于“最大持续time”参数。
左 Y 轴自适应	控制左 Y 轴是否伴随曲线data范围自动调整。
右 Y 轴自适应	控制右 Y 轴是否伴随曲线data范围自动调整。
左 Y 轴警戒线 1	switch
左 Y 轴警戒值 1	按照设置值虚线显示在曲线展示器上
左 Y 轴警戒线 2	switch
左 Y 轴警戒值 2	按照设置值虚线显示在曲线展示器上

右 Y 轴警戒线 1	switch
右 Y 轴警戒值 1	按照设置值虚线显示在曲线展示器上
右 Y 轴警戒线 2	switch
右 Y 轴警戒值 2	按照设置值虚线显示在曲线展示器上

3.12.4 dataexport

图 51 dataexport示意

1. 单击“export”button， 选择exportdata存储路径后即可Complete。

dataexport文件包含所有曲线data ，文件format为 csv ，可直接使用 EXCEL 打 开。

3.12.5 筛选设备

如data曲线过多 ，为方便View相同设备下的所有data曲线 ，可通过筛选设 备Function ，隐藏暂时不需要View的data曲线 （图例）。

图 52 筛选设备示意

1. 单击“筛选”button， 打开设备筛选页面。

2. 选择需要呈现的其data曲线equipment。

3.13 通道message管理

通道message作为重要debug信息 ，MThings 提供完整且友好的方法进行message管 理。

3.13.1 View通道message

图 53 View通道message示意

1. 软件默认不Openmessage浏览窗口 ，需勾选“message”，则message窗口将嵌入

软件窗口的下方。

2. 查阅message窗口。

3. 单击“停靠”button， message页面将弹出作为独立窗口。一般可用于电脑 多屏Scene，debugOperation和message浏览互不影响。

表 15 message颜色定义

颜色	含义
蓝色	正常sendmessage
绿色	正常receivemessage
红色	异常message
紫色	链接状态事件

为便于用户识别，如receive到 MODBUS-TCP message ，message显示时将 MBAP 中sendSerial number、协议Type、dataLength共 6 byte作为首部放入一对“[ ]”中。

3.13.2 通道message控制

图 54 通道message控制示意

1. 软件默认启动即receive所有链接message ，勾选“receive”后，可开始或Close messagereceive。

2. messagereceiveOpen后 ，软件默认Open“定时Clear”Function， message窗口中每满 2000 条记录将自动Clear窗口， 防止高速message占用过多电脑内存。勾 选“定时Clear”可Open或Close定时ClearFunction。

3. 基于可视化 ，软件针对 MODBUS-ASCII、MODBUS-TCP 进行部分 加工转换 ，如debug过程中需要 ，可勾选“原始byte流”View原始二进 制byte流message。

4. messagereceive后默认不存盘 ，如需存储 ，可勾选“存储”，软件立即开始 创建message文件，并开始data存盘（周期 10 秒更新）。

5. message存储默认路径是当前用户桌面 ，如需修改 ，单击“存储路径”按 钮，选择新的message文件路径。

6. 单击“立即Clear”button，可Clearmessage窗口中所有message。

7. 单击“筛选链接”button，指定部分链接，可将暂不关心的链接message过 滤。

筛选链接后，被过滤的message将不会存盘。 定时Clear或手动Clear不会影响存盘data。

3.13.3 串口抓包

如需进行串口抓包， 在目标串口链接中创建任意一个模拟主机设备即可，

无需设备data配置， 进入链接message窗口即可View被监听串口收到的所有data。

不Recommended for use MThings 进行串口抓包，建议选择通用串口Tools。

3.14 systemdata

systemdata页面提供configurationFunction，支持用户基于已有equipmentdata进行灵活而直观 的data展示和Operation ，该Function需获得授权后使用。

图 55 systemdata页面示意

3.14.1 进入configurationEdit

图 56 进入configurationEdit示意

3.14.2 退出configurationEdit

再次双击systemdata画布眉头，退出configurationEdit。

3.14.3 页面总体参数

进入configurationEdit后，将自动弹出“页面参数设置”对话框，用户可修改页面总

体参数。

表 16 页面总体参数定义

参数	用途&配置方法
标题	控制画布眉头居中位置显示标题内容。
背景色	如画布无底图，可双击该参数， 填充统一的背景色。
画布宽度	控制画布的显示区域宽度，numerical value与分辨率单位相同。
画布高度	控制画布的显示区域高度，numerical value与分辨率单位相同。
画布底图	设置一张用户Customization的大底图， 双击参数区域后，选择底 图路径， 图片应为.png 图片format。 建议底图分辨率与画布宽度、高度一致。

3.14.4 添加图形控件

图 57 添加图形控件

图形控件的添加过程需Complete 4 步配置：

第一步， 从左侧菜单栏中选择图形控件Type后， 拖入画布中；

第二步，设置“基本参数”，其中包括控件所属页面、位置、大小、data更 新周期；

第三步，设置“扩展参数”，不同控件Type的扩展参数不同；

第四步，添加“内容data”，即将该控件关联一个或多A devicedata，部分控 件无需关联设备data。

3.14.5 修改图形控件

进入configurationEdit后，已existence的图形控件点击后将出现蓝色线框，用户可通过 鼠标拖动的方式，快速修改图形控件的大小。

用户可通下图方式，快速调节图形的大小、位置、对齐方式等。

图 58 修改图形控件

1. 调整选中控件上对齐

2. 调整选中控件下对齐

3. 调整选中控件左对齐

4. 调整选中控件右对齐

5. 调整选中控件横向居中

6. 调整选中控件纵向居中

7. 调整选中控件横向分布

8. 调整选中控件纵向分布

9. 调整选中控件设置宽向相同

10. 调整选中控件设置窄向相同

11. 调整选中控件设置控件相同的高 度宽度

12. 将选中的控件图层置于顶层

13. 将选中的控件图层置于底层

14. 选择画布中的控件， 点击Copy会 出现相同的控件

15. 选择画布中的控件进行Delete

3.14.6 控件说明

名称	效果图	Function说明
dataTags		显示data名称、numerical value、单位； 双击后，Editnumerical value并下发指令； 支持多种名称和numerical value布局方式。
静态Text	标注信息	显示静态Text信息； 可设置字体大小和颜色。
多行表格		展示多条不同设备的data。
日间时期		展示本地time。
页面Tags		通过点击不同的页面Tags可以Switch不 同的界面信息展示。
滑块		以滑块方式快捷调整numerical value参数； 支持浮点指令； 可Customization控件背景和numerical value颜色。
设备状态		关联设备列表中设备进行通讯状态展 示。

switch		直观展示状态量； 用户可手动触发下发switch状态； 支持Customization状态值（非 0/1）。
分割线		辅助控件Category展示的分割线。
流动线		基于底图管道， 追加动态流向效果； 支持调整线条颜色、宽度； 支持多个折点； 支持关联设备data触发流动或静止。
电量		展示剩余电量data； 支持定义data范围、refresh步长； 支持定义警戒值，自动匹配警戒色。
图形switch		直观展示状态量； 多种switch样式； 用户可手动触发下发switch状态； 支持Customization状态值（非 0/1）。
仪表盘		直观展示numerical value名称、numerical value、单位； 支持调整范围、显示精度、单位； 支持修改numerical value颜色。

速度仪		直观展示numerical value名称、numerical value、单位； 支持调整范围、单位； 支持修改numerical value颜色； LCD 码呈现整形data。
进度盘 1		直观展示data绝对值及其百分比； 支持调整实际data范围。
进度盘 2		直观展示data相对范围百分比； 支持调整实际data范围。
指南针		直观展示角度data（0~360）； 支持浮点data。
temperature计		直观展示temperaturedata； 支持Customization范围； 支持负数temperature； 支持浮点数； 支持修改刻度颜色。

底图		用于局部增加图片展示； 支持导入本地任意路径中的图片； 支持常用的图片文件format。
实时曲线		同时展示最多 3 组data的曲线； 支持修改展示time范围； 最大可展示 24H data； 支持修改曲线、坐标轴颜色。
历史曲线		展示一条历史data曲线； 支持修改展示time范围； 最大可展示 180 天data； 支持修改曲线、坐标轴颜色。
报警简表		窗口展示所有活动告警； 支持动态变化显示。
报警统计		展示活动告警关键统计data； 自动关联告警Function。

3.15 历史data

历史data页面提供设备data持久化存储、展示、打印、exportFunction，支持按 日生成独立的data文件，统计data概要信息。该Function需获得授权后使用。

图 59 关联设备data存储示意

历史data的Operation与设备data强关联，用户需先行在“data”页面中，将待 存储的data项勾选“存储”。

为避免用户配置过程中的反复Operation，历史data存储配置后， 重启 MThings 方能生效。

避免频繁修改存储配置，建议data配置debug稳定后再Enable历史data存储功 能。 历史dataRelated配置的变化都需要重启软件！

图 60 历史dataFunction示意

1. Refresh Historydata显示表，后台历史data不会主动更新页面中的表格，如 长time停留在当前页面，需要手动点击“refresh”buttonView最新的历史 data记录。

2. Switch历史datarefresh的日期， 为避免同时load的data过多，历史data显 示表中每次仅load一天内data。

3. 筛选time段，筛选结果将影响“data概要”、“报表打印”、“data导 出”的data范围。

4. 筛选需要呈现的data列。

5. 计算Loaded的各项历史data“maximum”、“minimum”、“平均值”。

6. 打印Loaded的历史data，用户可选择打印data列、纸张Type等信息。

7. exportLoaded的历史data，exportdata format为 csv。

8. 显示历史data抬头， 如system参数中设置为空，则不显示。

9. 历史data显示表翻页、跳转Function。

3.16 data网关

data网关Function提供协议转换和data汇聚Function，可实现不同的通道Type、协 议Type、 Device address、register address、data块、data type、dataLength的双向转换。 该Function需获得授权后使用。

摩尔信使 MThings 支持两种模式实现data网关Function，分别是： 透传模式和 缓存模式。

透传模式配置简单， 但相比全流程时延大，北向受制于南向。缓存模式利 用模拟主机自身的轮询Function， 直接Response北向Request，可将南北向设施解耦，北向 远程监控软件可实现更加高效的异步通信。

借助模拟从机data中的“关联模式”，可实现将多个南向设备data汇聚到一 个北向模拟从机中， 可以大幅减少北向远程监控软件的Request次数，提升轮询效 率。 该种模式下可以实现更加广泛的data转换能力。 配置说明参考： 3.11 章

节。

两种模式下的data流示意图如下：

图 61 透传模式data流示意

图 62 缓存模式data流示意

3.16.1 透传模式应用

摩尔信使 MThings 支持通过透传模式关联两个不同设备（模拟从机和模拟 主机），以实现通道、协议、Device address转换Function。

准备工作：

1) MThings 中创建模拟主机，接入南向的串口设备；

2) MThings 中新建一路网络链接， 用于与北向软件connect；

3) MThings 中基于新增的网络链接，新增模拟从机；

图 63 透传模式equipment配置

1. 双击新建的从机设备。

2. 双击绑定模式后选择透传模式。

3. 双击绑定设备。

4. 选择绑定equipment。

经过设备关联和建链后，北向“远程监控软件”即可使用以太网通过 MThings 访问南向的串口设备。

透传模式下的从机可不配置设备data。

3.16.2 缓存模式应用

摩尔信使 MThings 支持通过缓存模式关联两个不同设备（模拟从机和模拟 主机），以实现通道、协议、Device address转换Function。

准备工作：

1) MThings 中创建模拟主机，接入南向的串口设备；

2) MThings 中新建一路网络链接， 用于与北向软件connect；

3) MThings 中基于新增的网络链接，新增模拟从机；

图 64 缓存模式配置及设备绑定

1. 双击从机设备。

2. 双击绑定模式。

3. 选择缓存模式并保存。

4. 绑定需要对外转发dataequipment。

缓存模式下的从机可不配置设备data，但其关联的模拟主机应配置effective数 据，并发起轮询。 缓存模式下，若北向设备的Requestdata多于南向设备的配置将自动补 0。

3.17 告警data

告警data页面提供设备告警生成、存储、配置、展示、exportFunction、语音提 示，支持多条件、跨设备生成告警信息，参照标准：《IEC 62682:2014》、

《GB/T 41261-2022 过程工业报警system管理》。该Function需获得授权后使用。

图 65 告警dataFunction示意

1. Switch告警记录Type， 活动告警分为“需Confirm”、“无需Confirm”两类，需

Confirm的活动告警记录需已恢复且已被Confirm才会转换为历史告警。

2. 维护告警配置入口。

3. 一键Clear all告警记录。

4. 一键Confirm所有需Confirm的活动告警。

5. export所有告警记录， data format为 csv。

6. 双击后，Confirm某一条活动告警记录。

7. 告警data显示表翻页、跳转Function。

图 66 告警配置Function示意

1. 新增一条告警配置。

2. Remove选中的告警配置。

3. Edit告警Type，用于Category不同的告警配置。

4. 告警配置记录表。

5. 告警条件配置对话框。

表 17 告警信息配置表参数定义

参数	用途&配置方法
名称	指定告警名称。
Type	根据预先配置的告警Type表，选择当前配置所属Type。
级别	可选：重要、次要、提示。
语音提示	勾选选项后会根据故障级别发出不同语音提示
人工Confirm	指定当前告警配置是否需要用户Confirm。
生成延时（秒）	防止告警抖动，设置告警生成延时，告警条件持续在该时

间段内成立后方能生成活动告警记录。
恢复延时（秒）	防止告警抖动，设置告警恢复延时，告警条件持续在该时 间段内不成立后方能将活动告警标记为已恢复。
条件 1	告警触发条件 1
关系	告警触发条件 1 和 2 之间的逻辑关系
条件 2	告警触发条件 2
关系	告警触发条件 2 和 3 之间的逻辑关系
条件 3	告警触发条件 3

表 18 告警条件配置表参数定义

参数	用途&配置方法
Enable	Enable该触发条件后， 打开此switch。
设备	选择关联equipment。
data	选择关联equipmentdata。
触发方式	选择触发Type，可选：大于、大于等于、等于、不等于、 小于等于、小于、介于、不介于。
阈值 1	与触发方式配套的条件判断阈值。
回差 1	条件不成立时的回差amplitude。 “等于”“不等于”触发方式下不生效。
阈值 2	仅作用于“介于”、“不介于”触发方式。
回差 2	仅作用于“介于”、“不介于”触发方式。

3.18 CustomizationRequest

MThings 支持用户基于创建的模拟主机设备sendCustomizationmessage，message需遵循 MODBUS 协议要求。

用户只需填入message PDU 部分 ，MThings 自动适应设备所使用的协议类 型，添加message首尾， 最终sendComplete message。

MThings CustomizationFunction支持统计messageRequest延迟time，支持持续曲线监控延迟 time，可用于观察从机的性能和可靠性。

CustomizationRequestFunction仅服务于模拟主机，可使用标准function code或Customizationfunction code。 CustomizationRequestOperation前，请于左侧设备列表Confirm当前设备是否正确。

图 67 CustomizationRequestOperation示意

1. 单击“Customization”主菜单，进入CustomizationRequest页面。

2. 单击“新增”button， 新建一条CustomizationRequest信息行。

3. 单击“Remove”button， Delete被勾选的CustomizationRequest信息行。

4. 单击“曲线”button， 打开“data曲线展示器”，可View延时time曲线 data。

5. 单击“send”button， send被勾选的CustomizationRequest信息。

6. 如果需要loop sending ，勾选“loop sending”。

7. 用于输入Customizationmessage PDU。

8. 显示CustomizationRequest与Response之间的延迟time ，不可Edit。

9. 可配置当前行的CustomizationRequest的超时time，即最大允许回复的time范 围。超过该time，即判Request超时。

10. 可配置当前行的CustomizationRequest&ResponseEnd后的间隔等待time，该间隔时 间End后，才能发起下一个Request。

11. 选择后 ，软件将该行CustomizationRequest的延迟time作为data曲线长期监视。

3.19 message统计

MThings 支持模拟主机设备和模拟从机设备在通信交互过程中同步统计报 文交互data。

1. 通过判别各种收发情形，准确统计丢包率，细分异常Type。

2. 支持对丢包数持续曲线监控，供用户识别丢包规律。

3. 支持以链接和设备两个不同维度进行统计 ，可同时View链接下总数 据 ，也可以View各自设备的统计data。

图 68 统计Operation示意

1. 单击“统计”主菜单，进入统计页面。

2. 软件启动时 ，默认Close统计Function ，需单击“启动”button开始统计功 能。

3. 用于Switch统计结果的维度 ，分为设备和链接。选择设备时，统计data 列表中包含所有通信设备的统计结果。选择链接时， 统计data列表中 包含所有通信链接的统计结果。

4. 单击“重置”button， 所有统计data归 0，开始重新计数。

5. 单击“曲线”button， 打开“data曲线展示器”，可View丢包数曲线。

6. 勾选“自动refresh”，表格中data持续refresh，否则，表格中data暂停刷 新。

7. 选择需要持续曲线监视丢包数的对象。

表 19 统计data项定义

data	含义
send正常	已成功send至链接
receive正常	receive到正常主机Request或从机回复data
丢包率	仅适用于模拟主机 丢包率（%） = （send正常 – receive正常 – Response异常） / send正常
send失败	由于链接异常，导致data无法发出
Response异常	从机回复异常帧（Requestfunction code + 0X80）
Response超时	未收到从机正常Response帧
帧长异常	receive到的data无法正常Parse
校验异常	receive到的message出现如下校验Error： CRC、LRC、帧Serial number、协议Type

统计过程中必须有设备通信message ，不支持抓包过程统计。 如链接中出现异常message ，无法识别其所属Device address ，该类异常message将被归为 “其它”设备中。 建议统计过程中同步存储Original message，便于问题分析。

3.20 辅助小Tools

MThings 作为常用 MODBUS 调测Tools，同时提供多项辅助Tools，有助于

进阶messagedata分析。

图 69 辅助小ToolsOperation示意

1. 单击“辅助”主菜单，进入辅助页面。

2. 纪元秒与标准time（UTC）的换算 ，支持各自修改 ，自动同步。

3. 不同Type的numerical value换算，支持各自修改，自动同步。

4. byte流处理Function ，输入待分析的byte流或字符串。

5. byte流处理Function ，单击“字符串”button，可将输入的码流转换为字符 串format。例如可将码流“31 32 33 34 35 36 37 38 39 30”转换为 “ 1234567890”。

6. byte流处理Function ，单击“码流”button，可将输入的字符串转换为码 流。例如可将字符串“1234567890”转换为“31 32 33 34 35 36 37 38 39 30”。

7. byte流处理Function ，单击“CRC/Size”button，可统计计算码流data的

CRC16 和byte个数，其结果展示于下方。

8. 展示码流和导入文件的binaryComputation result。

9. 文件分析Function，单击“导入”button，可导入一份binary文件 ，软件将 分析出文件的byteLength、文件总 CRC16，其结果展示于上方。

10. 文件分析Function，单击“export”button，软件将导入的binary源文件转换 为码流Text文件。

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

RS485	工业常用的差分串行通信标准，支持多点通信
function code	Modbusfunction code指定读/写OperationType，如01读线圈、03读保持register
register	Modbus register存储data单元，分线圈/离散输入/保持/输入register四类
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 Node-RED 字数 22833 字 · 阅读约 58 分钟 更新 2023-08-03 永久链接 https://www.modbus.cn/23963.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批量读取register的maximum quantity及影响因素
• 风机盘管控制器产品说明书（大屏版）
• Modbus ASCIIdatamessage结构详解
• Modbus(三色灯款)声光报警器通讯协议
• 霍德森G9新风机Modbus通讯协议
• Modbus Poll 中文版用户手册及软件Download
• 萧育青工作室“ Modbus Tools集”,用于 Modbus 设备的通信仿真及debug
• Modbus协议的工作原理与应用Scene