摩尔信使MThings快速入门使用指南

功能概述

本指南面向第一次使用摩尔信使MThings的工程人员，按照软件当前界面和配置关系，从一个空白.mthings工程文件开始，完成“新建工程—添加通信通道—添加现场设备—建立第一个数据点—单次读取—启动轮询—查看通信报文—保存并重新打开验证”的完整闭环。

指南以最常见的“MODBUS-TCP现场设备只读采集”为主示例，同时说明串口、S7、电表和IEC协议在入口上的差异。完成本指南后，至少应得到一个能够持续显示正确现场值、可以保存并再次打开的工程配置。

MThings界面把可交付的工程称为“配置”，项目文件扩展名为.mthings。本文中的“项目”和“配置文件”指同一份工程配置。

关键字

摩尔信使MThings，MThings快速入门，新建工程，工程菜单，配置菜单，添加通道，通道设备表，添加设备，MODBUS-TCP，数据点，启动轮询，通信报文，保存工程

功能详解

一、开始前准备

1.1 最少资料清单

不要在资料不全时批量录入点表。第一次接入至少准备以下信息：

第一次测试优先选择一个只读、变化缓慢且现场值已知的数据点。未经现场授权，不要用生产设备的线圈、保持寄存器、遥控点或设定值做写入测试。

1.2 确认当前用户身份

通道、设备和数据点配置需要管理员权限。使用配置 > 用户管理切换本地身份；如果当前为终端用户，新增或修改时软件会提示无权限。

1.3 理解软件中的对象关系

MThings的基础配置关系如下：

.mthings配置文件
└─ 通信通道（串口或网络，包含传输协议和通信参数）
   └─ 设备（现场设备、仿真从站或本机设备）
      └─ 数据点（地址、类型、换算、轮询和写入参数）
         ├─ 实时曲线
         ├─ 历史
         ├─ 告警
         ├─ 控制
         ├─ 系统组态
         ├─ EdgeWeb
         └─ MQTT

设备可以关联一个或多个兼容通道，但入门项目建议一台设备只关联一个通道。必须先让基础数据稳定，再配置历史、告警、控制、组态页面或对外转发。

现场设备用于访问外部硬件，仿真从站用于接受外部主站的协议访问，本机设备用于软件内部变量和测试数据。原始类型描述设备编码，呈现类型描述显示与输入形式；当前缓存值、一次新的现场读取和一条历史记录是不同结果。先弄清这些概念，再决定每项参数应在哪一层设置。

二、认识主界面

软件中央显示一个“默认主页”，可在数据、系统、告警、历史或控制之间选择；顶部使用“工程、配置、监视、工具、帮助”五组菜单。入门阶段建议把“数据”设为默认主页，直接使用中央的通道设备表和数据点表。

左侧通道或设备名称支持双击修改参数：双击通道名称打开通道参数，双击设备名称打开设备参数。右键菜单提供更完整的运行和维护操作。

2.1 路径表示方法

本文使用菜单或页面 > 区域 > 操作表示点击顺序。例如：

数据 > 通道设备表 > 右键通道 > 添加设备

• “页面”指中央默认主页或从菜单打开的独立页面；
• “工程”“配置”“监视”“工具”“帮助”指主窗口顶部菜单；
• “右键通道”“右键设备”“右键数据行”指对应对象的上下文菜单；
• 带引号的页面、按钮和菜单名称均采用软件中文界面名称；
• 铅笔图标等没有文字的按钮，本文使用界面图标和位置描述。

2.2 配置文件与全局功能路径

2.3 通道、设备与数据功能路径

2.4 应用功能与监视窗口路径

如果某个页面已经是中央默认主页，其同名菜单项会自动隐藏。可直接在中央页面操作，或先在配置 > 选项中把“默认主页”切换到其他页面，再从菜单打开该页的独立窗口。

三、完整示例：接入一台MODBUS-TCP设备

以下示例假设：

• MThings主动连接设备，因此“链接模式”选择“TCP客户端”；
• “传输协议”选择“MODBUS-TCP”；
• “设备类型”选择“现场设备”；
• 设备地址为192.168.1.50，端口为502；
• Unit ID为1；
• 第一个点位是输入寄存器零基地址0，类型和长度以现场点表为准。

示例地址仅用于说明操作位置，不能直接用于生产设备。

3.1 新建并立即落盘配置文件

操作路径：工程 > 新建

1. 打开顶部“工程”菜单。
2. 选择“新建”。
3. 在文件对话框中输入文件名，例如锅炉房采集_调试.mthings。
4. 保存到项目资料目录，不建议保存在软件安装目录。软件检测到安装目录路径时会给出提醒或确认。
5. 新建成功后，软件清空当前工程内容、创建空白.mthings文件并将它作为当前配置。

如果当前配置已有未保存修改，执行新建、打开或关闭软件时会出现保存确认。不要把“不保存”理解为自动保留草稿。

3.2 进入“数据”页

操作路径：数据

1. 如果中央已经显示“通道设备表”，说明“数据”是当前默认主页，可直接操作。
2. 如果中央显示其他页面，选择配置 > 设备数据，在打开的独立窗口中操作；也可进入配置 > 选项，把“默认主页”改为“数据”。
3. 确认左侧出现“通道设备表”。空白配置中可以没有任何通道和设备；默认主页设置属于软件界面设置，不等同于项目点表。

3.3 添加网络通道

操作路径：数据 > 通道设备表 > 添加通道

1. 点击左侧“通道设备表”上方的“添加通道”按钮。也可以在左侧空白处右键选择“添加通道”。
2. 在“添加通道”对话框选择“网络通道”。网络通道名称由软件自动生成，例如NET001；可以在“别名”中填写易识别的现场名称，例如“锅炉房温控器”。左侧树优先显示别名。
3. 在页面下方选择：

• “链接模式”：TCP客户端；
• “传输协议”：MODBUS-TCP；
• “设备类型”：现场设备。

1. 在参数表填写：

• “目标域名/IP”：192.168.1.50；
• “目标端口”：502；
• “本地IP”：多网卡电脑按实际出口网卡选择；无特殊绑定要求时双击该项并选择ANY，表格中会显示为--；
• “本地端口”：客户端通常可保留自动分配值；
• “重新建链周期”“链接空闲保持时间”等参数先保留默认值，除非设备或现场网络有明确要求。

1. 点击“添加通道”。成功后，左侧出现新通道。

“链接模式”“传输协议”和“设备类型”是联动选项，软件只允许有效组合。已经有设备的通道不能直接跨协议族修改传输协议；需要改协议时应先备份，再按提示处理原通道及设备。

3.4 添加设备

操作路径：数据 > 通道设备表 > 右键通道 > 添加设备

1. 在左侧右键新建的通道。
2. 选择“添加设备”。
3. “所属通道”和“设备类型”来自当前通道，不需要再次选择。
4. 将“起始站号”和“结束站号”都填写为1，点击“添加”。这会添加一台Unit ID为1的设备；填写一个范围会批量建立多个站号，不适合第一次验证。
5. 展开通道并单击设备行。右侧应切换到该设备的数据点表。

MODBUS-TCP直连设备有时不使用Unit ID，但MThings仍以站号组织设备；经过TCP/RTU网关时，该值通常决定访问哪台下游从站，必须按设备或网关说明填写。

西门子S7是单通道单设备协议。创建S7通道时软件会自动建立对应设备；如果通道下已经出现设备，不要再重复寻找“添加设备”。

3.5 建立第一个数据点

操作路径：数据 > 通道设备表 > 单击设备名称 > 右侧数据工具栏 > 新增数据

1. 选中左侧设备，确认右侧数据表已经启用。
2. 点击数据点工具栏中的“新增数据”。软件会在当前设备下增加一行默认配置。
3. 直接编辑可输入的文本或数字单元格；对于数据区、原始类型、呈现类型、字节序、字序等选项，双击单元格打开选择窗口。
4. 点击工具栏“更多参数列”，显示完整通信字段。
5. 按设备手册逐项填写。对于本示例，至少核对以下字段：

数据点编辑后会更新当前运行配置，但只有执行工程 > 保存才会写入.mthings文件。地址、类型或长度修改后，先重新做单点读取，不要立即批量复制到全部设备。

3.6 先做一次单点读取

操作路径：数据 > 通道设备表 > 单击设备名称 > 双击数据行“数值”单元格

1. 在新数据点的“数值”单元格上双击。对于现场主站设备，这个操作会对该数据点发起一次读取。
2. 观察“数值”是否由--变为实际值。
3. 如果没有值，先进入下一节打开报文窗口，再判断是没有发送、没有响应、协议异常还是数据解释错误。

单次读取用于缩小问题范围。只有一个已知点能够稳定读取后，才开始连续轮询和批量添加点位。

3.7 连接通道并启动轮询

操作路径：数据 > 通道设备表 > 右键通道 > 连接，然后执行右键设备 > 恢复设备/启动轮询

通道和设备创建后通常会进入运行流程；若状态为关闭、禁用或已经手动停止，可按以下方式恢复：

1. 右键通道，选择“连接”。
2. 右键设备，选择“恢复设备”。
3. 右键设备，选择“启动轮询”。
4. 保持测试点“轮询”列为勾选状态。
5. 连续观察数值至少数个采集周期，确认没有频繁变为--或长时间不更新。

“连接成功”“设备正常运行”和“数值正确”是三个不同结论：

3.8 打开“报文”窗口验证通信

操作路径：工具 > 报文

1. 打开顶部“工具”菜单。
2. 选择“报文”，软件显示并激活独立通信报文窗口。
3. 确认报文窗口中的“接收”开关处于启用状态。
4. 再双击一次数据点“数值”，或保持轮询运行。
5. 观察通道状态、发送、接收、超时、帧错误或校验错误记录。
6. 多通道项目可使用“筛选通道”；需要对照设备手册时可启用“原始字节流”。

报文窗口还支持清空、报文着色、停靠/弹出和存储。存储前应检查报文中是否含有敏感设备地址、控制值或业务数据。

3.9 核对数值解释

操作路径：数据 > 通道设备表 > 单击设备名称 > 更多参数列

收到响应但值不合理时，按以下顺序一次只改一个字段：

1. 数据区块和地址；
2. 数量或字节长度；
3. 原始类型及有无符号；
4. 位偏移和位数；
5. 字节序和字序；
6. 系数和偏移；
7. 单位、小数位或枚举显示。

先确认原始解释，再做工程换算。一个“看起来合理”的稳定值不等于地址一定正确，应至少与设备面板、PLC在线值或另一款已验证工具在两个不同工况下对照。

3.10 保存并重新打开验证

操作路径：工程 > 保存；复核时使用工程 > 打开

1. 打开“工程”菜单，选择“保存”。
2. 确认软件提示保存成功并显示当前.mthings路径。
3. 如需保留调试前基线，使用工程 > 另存为建立独立副本，例如锅炉房采集_已验证_20260915.mthings。另存成功后，新文件会成为当前工程。
4. 再通过工程 > 打开或工程 > 近期使用打开该文件。
5. 核对通道、设备、数据点、轮询勾选和数值解释仍然正确。

软件下次启动时会尝试打开上次使用的配置文件，也可以直接把.mthings文件作为启动参数交给程序。自动打开不替代人工保存；未保存修改不会因为仍显示在当前界面就自动成为可恢复配置。

四、串口设备的操作差异

操作路径：数据 > 通道设备表 > 添加通道 > 串口通道

接入MODBUS-RTU、DL/T645、CJ/T188、DL/T698.45或IEC101串口设备时，整体流程不变，但“添加通道”步骤改为：

1. 选择“串口通道”。软件只列出当前可用或已配置的COM口；若没有可用串口，会自动切换到网络通道页面。
2. 选择目标COM口。
3. 选择“传输协议”和“设备类型”。
4. 按设备手册填写波特率、校验方式、数据位、停止位、流控和DTR等参数。
5. 点击“添加通道”，再右键通道添加设备。

串口通道打开成功只说明端口可被MThings占用，不说明RS-485接线、A/B极性、站号和协议参数正确。同一RS-485总线上的设备应使用一致的串行参数和互不冲突的站号。

对于支持扫描的MODBUS、DL/T645、CJ/T188和DL/T698.45现场设备通道，右键通道可看到“设备扫描”。扫描会产生现场通信并遍历站号或串口参数组合，必须先评估总线负载；入门时更建议按已知地址手动添加一个设备。

五、不同协议的数据入口差异

选中设备后，MThings会按通道协议打开对应的数据配置页面，不会把所有协议强行显示成Modbus寄存器。

具体字段和使用限制请转到相应协议指南，不要照搬MODBUS示例：

六、常用操作速查

6.1 通道设备表

工具栏右侧“设备详细信息”按钮可展开设备类型、地址和设备ID等列；默认简洁模式会隐藏这些列。

6.2 数据点表

七、受控写入验证

操作路径：数据 > 数据行“指令”输入值 > 双击“写”单元格

只读采集通过后，如确实需要验证写入：

1. 选择协议允许写入的数据区或对象。MODBUS中“线圈状态(RW)”和“保持寄存器(RW)”可写，“离散输入(RO)”和“输入寄存器(RO)”只读。
2. 使用经现场授权的测试点，确认允许范围、当前设备状态和恢复值。
3. 在“指令”单元格输入目标工程值。枚举类型可双击“指令”选择枚举项。
4. MODBUS 单个点可双击该行的“写”单元格；批量写入可选中相应“指令”单元格后右键选择“下发写指令”。IEC 控制点按对应协议指南操作，数据表的命令操作每次只选一个点；IEC103 仅类型 20 接受整数 0 或 1。
5. 查看发送和响应报文。
6. 再次读取目标点，并使用独立反馈点、设备面板或PLC状态确认设备真正接受了命令。
7. 测试结束后恢复安全值并保存经确认的配置。

对于寄存器中的位段写入，软件需要先取得当前寄存器值再组合写命令；因此界面明确提示写位指令前应先更新当前值。不要只根据“发送成功”判断阀门、电机或设定值已经到位。

八、常见问题与定位顺序

推荐始终按“通道—设备—单点报文—原始解释—工程换算—连续轮询—上层应用”的顺序定位。不要通过无限增加重试、缩短刷新周期或随意修改倍率来掩盖根因。

九、完成标准

完成以下检查后，才算完成第一个MThings入门项目：

• 已创建独立的.mthings配置文件，并知道当前保存路径；
• 当前用户具备配置权限，生产交付前已规划管理员和终端用户边界；
• 通道类型、链接模式、传输协议和设备类型与现场角色一致；
• 通道能够连接或打开，报文窗口可看到预期的发送与接收；
• 设备身份与现场一致，且只添加了需要验证的设备；
• 至少一个只读数据点能够单次读取并持续轮询；
• 数据值与可信现场参照在至少两个工况下相符；
• 项目已保存，并从该.mthings文件重新打开验证；
• 需要写入时，已经完成授权、范围、写后读回和独立反馈检查；
• 在添加历史、告警、控制、组态、EdgeWeb或MQTT之前，基础采集已稳定运行。

十、下一步阅读

基础接入完成后，可按需求继续阅读：

注意事项

• 工程 > 新建会清空当前工程内容；打开其他工程也会切换整个工程。看到保存确认时先判断当前修改是否需要保留。
• 删除通道会同时影响其设备；删除数据点会影响历史、告警、控制、组态、EdgeWeb和MQTT等引用。
• 通道参数修改会影响所有绑定设备。修改链接模式、协议、串口参数、IP或端口后，应重新完成连接、单点读取和持续轮询验证。
• .mthings文件保存工程配置，但项目外部的历史数据库、网页资源、TLS证书、导出文件和模板应按部署情况另行备份。
• MThings用于数据采集、监视和自动化联动，不应替代设备本体保护、独立安全联锁和现场操作规程。