QModMaster免费连上 RTU/TCP 设备的 ModBus 主站工具【免费下载链接】qModbusMasterFork of QModMaster (https://sourceforge.net/p/qmodmaster/code/ci/default/tree/)项目地址: https://gitcode.com/gh_mirrors/qm/qModbusMasterQModMaster 是一款基于 Qt 的免费开源 ModBus 主站工具专门解决 ModBus 设备连不上、数据读不出的问题。它同时支持 RTU 和 TCP 两种协议自带总线监控、寄存器读写和日志记录Windows 和 Linux 上体验一致。一、项目全景30 秒建立认知项目内容项目名QModMaster协议类型ModBus RTU串口、ModBus TCP网络支持平台Windows、Linux许可证GPLv3核心依赖libmodbus 3.1.0ModBus 通信、QsLog日志、Qt 5.2.1 及以上适用场景寄存器与线圈读写、通信故障排查、周期性轮询、长时间稳定性观察它不是从站模拟器也没有网关转发、数据落库或组态上位机的功能定位就是一个纯主站调试工具连上真实设备把数据读出来把问题查清楚。你要不要直接和设备对话是判断它值不值得装的唯一标准。从源码结构看它就是一个标准 Qt 工程打开就能看到全部功能没有黑盒。二、从零到连接只做两件事拿软件Windows 用户最省事下载预编译版本解压就能运行不需要安装免安装也意味着没有后台服务拷到 U 盘就能在隔离网络里用。想编译或二次开发再走源码这条路git clone https://gitcode.com/gh_mirrors/qm/qModbusMaster编译只依赖 Qt 5.2.1 或更高版本用 Qt Creator 打开根目录的 qModMaster.pro 工程文件直接构建即可libmodbus 和 QsLog 两个库已经放在 3rdparty 目录里不用额外安装任何东西。通设备选 RTU 还是 TCP取决于设备接的是串口线还是网线。模式定下来之后你只需要填这几项协议模式RTU串口或 TCP网络从站地址设备在总线上的编号RTU 参数串口号、波特率、校验位、数据位、停止位TCP 参数设备 IP 和端口ModBus 默认 502超时时间等待响应的上限RTU 模式还要注意串口设备名Windows 下通常是 COM 口Linux 下是 /dev/tty 开头的设备。第一次测试建议用 TCP 模式连本机回环或内网设备参数最少出问题的环节也最少。点连接之后状态栏的指示图标会变绿——这就是通了你能拿到的第一个可验证信号。三、能力地图QModMaster 到底能干什么看总线监控发送帧和接收帧逐帧解析从站地址、功能码、数据、错误标记一条条列出实现见 总线监控器实现帧级记录每条报文带时间戳支持十六进制和 ASCII 两种格式日志可保存到文件网络诊断Tools 面板内置 ping 和端口连通性测试先把网络层排干净再谈协议层读写四类对象全覆盖线圈功能码 01/05/15、离散输入02、输入寄存器04、保持寄存器03/06/16显示格式可切十六进制、十进制、浮点有符号无符号、16 位 32 位都能调核心逻辑在 寄存器数据模型会话保存当前模式、从站地址、功能码、起始地址、数量整套参数存成文件下次打开直接恢复自动周期扫描设一个扫描间隔自动按节奏轮询状态栏实时累计报文数 Packets 和错误数 Errors超时控制单帧请求独立超时失败只计数不卡界面长时间运行也不会丢状态计数可清零报文数和错误数可以一键重置方便分段统计错误率扩展跨平台Windows 和 Linux 功能完全一致工程文件里平台差异已经处理好三语界面英文、简体中文、繁体中文菜单里一键切换分层清晰通信层、界面层、配置层各自独立加协议、改界面、定制功能都有切入点四、三个高频任务ModBus 操作照着做就行排查通信故障目标搞清楚通信断在哪一环——请求没发出去、响应没回来还是内容不对。操作打开总线监控器先看请求帧发出去没有再看响应帧回来没有最后对比两帧的从站地址和功能码是否一致。验证如果响应帧带着异常码回来问题就落在地址范围或参数上不用再反复怀疑线路和设备。批量读写寄存器目标一次性读出电表、变频器上的一组数据或者写入一组新参数。操作填起始地址和数量读选功能码 03写选 06单个或 16多个点请求做写入测试之前先把原值读一遍记录下来。验证数值出现在表格里把显示切成十进制后和说明书对得上就说明地址和格式都选对了。长时间稳定性观察目标确认链路长时间运行可靠错误率不随时间爬升。操作打开扫描开关设一个合理的间隔比如 5 秒挂机跑几个小时期间只看状态栏的 Packets 和 Errors。验证错误数始终接近 0 说明链路稳定错误率突然抬高多半指向现场干扰或设备问题。五、踩坑实录这些问题省你两小时RTU 连不上参数明明是对的现象点连接失败状态栏不变绿。原因Linux 下当前用户没有串口权限或串口被别的程序占着。解法把当前用户加入 dialout 组关掉占用串口的其他程序再连。能连上但一直报超时现象连接正常每次请求都超时。原因从站地址填错或起始地址、数量超出了设备实际范围。解法先核对从站地址再按说明书把起始地址和数量改回有效区间。TCP 模式连不上现象TCP 连接建立不了或建连后读不到数据。原因目标端口没开放或被防火墙挡掉。解法先用 Tools 面板 ping 目标 IP、测端口连通性确认网络不通就去防火墙放行 502 端口。数据读出来是乱码或负数现象读到的值明显不对或全是负数。原因显示格式和寄存器定义不匹配比如设备存的是 32 位有符号值。解法在显示设置里切到对应的有符号、32 位或十六进制档位对照说明书再核一遍。日志里看不到排障细节现象想追完整通信过程但日志很少。原因默认日志级别是 Warn3细节消息根本没写。解法把 QModMaster.ini 里的 LoggingLevel 改成 0Trace排完障再调回去。六、延伸文档、源码与二次开发想查文档仓库自带一套 HTML 格式的用户手册在 ManModbus 目录浏览器打开就能看Docs 目录里还有 ModBus 应用协议规范 PDF啃完这本协议就通透了想读源码通信层 src/modbusadapter.cpp 管连接、收发和轮询界面层 src/mainwindow.cpp配置层 src/modbuscommsettings.cpp三层分得干净从哪层切入都行想了解依赖底层是 libmodbusModBus 通信和 QsLog日志都是成熟的开源库文档资料多排障时能查到一手资料想二次开发GPLv3 协议模块化架构适合加协议、改界面、定制功能也可以整体集成进自己的自动化测试系统QModMaster 把参数配对、地址核对、格式切换这三件 ModBus 调试的核心事都做成了图形界面操作全程不用写代码。现在下载一份连上手边那台设备跑一次读取再打开一次总线监控器。【免费下载链接】qModbusMasterFork of QModMaster (https://sourceforge.net/p/qmodmaster/code/ci/default/tree/)项目地址: https://gitcode.com/gh_mirrors/qm/qModbusMaster创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
