首页 插件模块

Modbus 报文解析

Modbus 报文解析

MODBUS PARSE |
串口与 Modbus
报文变人话:自动识别协议与方向、逐字段拆解,选中 Hex 片段右键即出数值。
协议自动识别
寄存器数值换算
4 种字序

Overview

总体概览

一串十六进制报文并不直观,快速读懂一帧报文往往是现场调试的关键一步。Modbus 报文结构紧凑、字段含义固定,但人工逐字节对照协议规范既费时又容易出错。Modbus 报文解析工具只需在左侧输入框粘贴抓取到的原始十六进制报文(支持空格与换行分隔),选择该帧的数据方向(Request 请求 / Response 响应)与输出格式(Xml / Text),点击 Parse 即可完成解析——无需手动指定协议类型,工具会自动识别报文属于 Modbus TCP、Modbus RTU 还是 Modbus ASCII,并按方向自动匹配对应的报文结构。解析结果逐字段拆解后输出到右侧窗口,涵盖 MBAP 头、从站地址、功能码、起始地址、数量、字节数、数据区以及 CRC / LRC 校验等内容;在解析结果中选中十六进制数据后右键,还可按多种类型直接换算为具体数值。

Screenshots

界面预览

Modbus 报文解析 界面

Highlights

特性速览

粘贴 Hex 报文即解析,支持空格与换行分隔

协议自动识别:Modbus TCP / RTU / ASCII,无需手动指定

方向可选 Request / Response,字段含义按方向解释

输出格式 Xml / Text 可选;注释绿色、校验与异常红色

覆盖 MBAP 头、从站地址、功能码、地址、数量、字节数、数据区、CRC / LRC

选中 Hex 片段右键换算:Int16 ~ UInt64 / Float / Double / Binary 等

多寄存器类型支持大端、小端及字节交换等多种字序组合

Features

核心特性

01
帧结构逐字段解析

将完整报文粘贴到左侧输入框(支持空格与换行分隔),选择数据方向与输出格式后点击 Parse,解析结果逐字段拆解后输出到右侧窗口,涵盖 MBAP 头(事务号、协议标识、长度、单元标识)、从站地址、功能码、起始地址、数量、字节数、数据区以及 CRC / LRC 校验等内容,完整支持 01 / 02 / 03 / 04 读取与 05 / 06 / 0F / 10 写入等常用功能码的请求与响应。

02
自动识别与方向匹配

无需手动指定协议类型——工具会自动识别报文属于 Modbus TCP、Modbus RTU 还是 Modbus ASCII,并按方向自动匹配对应的报文结构。报文方向可手动指定(Request 请求 / Response 响应),例如响应报文中的“数量”字段会被解释为“字节数”,避免歧义。

03
错误与异常提示

当报文校验不通过时会明确给出错误原因;遇到从站返回的异常响应时会直接标注异常码;无法识别的报文也会给出提示,便于快速判断问题出在参数配置、数据校验还是设备返回异常。解析结果采用颜色区分——注释为绿色、校验错误与异常信息为红色,一眼即可定位问题所在。

04
寄存器数值换算

在解析结果中选中十六进制数据后右键,可按 Int16、UInt16、Int32、UInt32、Int64、UInt64、Float、Double、Binary 等类型直接换算为具体数值;多寄存器类型支持大端、小端及字节交换等多种字序组合。换算结果以独立窗口按序号列表展示,方便核对寄存器数值。

Scenarios

典型使用场景

现场抓包后的原始报文分析

把抓到的帧贴进来,立刻得到从站、功能码、数据内容与校验结果,报文含义一目了然。

主从站通信异常定位

对照请求与响应帧,判断异常出在参数配置、链路还是设备返回。

寄存器数值换算核对

把数据区字节按 Float、Int32、UInt32 等类型换算,核对工程值与状态字含义。

协议对接中的字段校验

核对设备手册的报文示例与实际抓包是否一致,验证字段理解是否正确。

Get Started

快速上手

7

在左侧插件树中找到 Modbus 报文解析,创建功能实例(可多开,同时解析多帧报文)。

7

在左侧输入框粘贴原始十六进制报文(支持空格与换行分隔)。

7

选择该帧的数据方向(Request 请求 / Response 响应)与输出格式(Xml / Text)。

7

点击 Parse,右侧窗口输出逐字段解析结果(注释为绿色,校验与异常信息为红色)。

7

在解析结果中选中十六进制数据并右键,选择类型与字序组合进行数值换算。

7

在独立窗口中按序号列表核对换算出的寄存器数值。

Under the Hood

深入一点 · 技术要点

报文解析按帧头特征自动区分协议变体:TCP 由 MBAP 长度字段界定,RTU 依据 CRC,ASCII 以起始字符标识,因此调用方无需指定协议类型。字序提供大端、小端及两种字节交换组合,覆盖主流 PLC 与国产设备的字节序差异——浮点数值“解析出来是乱值”通常就是字节序约定不同。解析结果中的注释段以绿色高亮渲染,原始数据与注释分开显示;奇数长度、非法字符与空输入均给出明确错误提示。

FAQ

常见问题

粘贴后提示长度不是偶数?
解析结果与预期不符?
Float 解析出来是乱值?
需要先选协议类型吗?
能解析不带校验的报文吗?

Works Well With

与其他插件协同使用

Modbus 主站

把主站日志中的 TX / RX 报文复制过来解析理解。

Modbus 从站

核对从站日志中的请求与响应帧。

串口调试

把串口抓到的 RTU 报文粘贴解析(含 CRC 校验)。

超级工具箱

先用它在 Hex 与文本之间转换、整理空格后再粘贴解析。

想要更完整的技术细节?

完整文档包含功能详解、进阶技巧、技术原理与常见问题,与源码一一对应。
查看完整 README
An unhandled error has occurred. Reload

连接已中断

当前会话仍然保持,我们将持续尝试恢复连接。

正在重新连接服务器…

重连失败,将在 秒后重试。

重连失败。请重试或刷新页面。

会话已被服务器暂停。

恢复会话失败。请重试或刷新页面。