Serial port debugging assistant software ATK-XCOM V3.0

Source: Modbus Chinese Network (modbus. cn) - a leading Modbus communication protocol technology community in China

The complete byte stream received, including frame header, address, function code, data, and checksum, is displayed in full. Used to troubleshoot frame structure issues - such as discovering that the number of received bytes is insufficient, possibly due to a short interval being truncated.

摘要：ATK-XCOM V3.0 由正点原子（ALIENTEK）开发，是国内嵌入式开发圈使用最广的串口调试工具之一。本文不仅覆盖其核心功能，更深入讲解它的协议传输模式——自动超时重发、校验和/异或/CRC8/CRC16 四种校验、数据帧与实际数据的分离显示——这些功能让 ATK-XCOM 在 Modbus RTU 调试场景中比普通串口助手高出一个量级。附带完整的 Modbus 调试操作指南和同类工具对比。关键词：ATK-XCOM、正点原子、串口调试助手、协议传输、Modbus RTU 调试、CRC16、校验和。

调试串口这件事，说简单也简单——找个串口助手，选对 COM 口和波特率，发个十六进制帧，看回来啥。说难也难——当你的帧发出去，设备回了，但你不知道回来的数据是不是对的，不知道丢没丢帧，不知道中间那两字节到底是不是正确的校验码。

ATK-XCOM V3.0 是正点原子团队开发的串口调试工具。正点原子在国内嵌入式圈的影响力不用多说——STM32 开发板、ESP32 模块、RT-Thread 教程，基本上学嵌入式的人都用过他们的东西。ATK-XCOM 是他们内部调试工具的外化版，功能构建来自真实的开发场景而非凭空设计。

一、软件怎么装

开发者：正点原子（ALIENTEK），国内专业的嵌入式开发解决方案提供商。长期专注于为工程师、学生和爱好者提供开发板、模块和配套工具。

系统要求：Windows 7 及以上，32/64 位均支持。实测在 Windows 10 和 Windows 11 上运行稳定，CH340、CP2102、FT232 等常见 USB 转串口芯片均正常识别。

二、基础功能速览

2.1 串口设置

打开软件后自动扫描所有可用串口，在串口下拉列表中可以看到对应的串口名称和详细信息（如 COM3: USB-SERIAL CH340）。常见的 CH340 芯片支持热插拔——USB 插上后点击刷新即可出现，拔掉后自动消失。部分老旧驱动可能需要手动关闭串口再打开。

波特率范围：预设 1200 ~ 1382400 bps，覆盖了所有标准速率。需要非标波特率（如 750000、921600）时，在串口关闭状态下点击「自定义」按钮，直接输入数值。前提是你的 USB 转串口芯片和对方设备的 UART 都能支持这个速率——STM32 的 USART 在 72MHz 时钟下支持的非标波特率范围很窄，不是随便输个数字就能稳的。

停止位：1、1.5、2 三种。数据位：5、6、7、8 四位。校验位：无校验、奇校验、偶校验。Modbus RTU 的标准配置：8 数据位、1 停止位、偶校验或无校验。

2.2 显示与发送

接收区支持两种显示模式：十六进制和 ASCII，可实时切换。两种配色方案：经典的「黑底绿字」（类似终端风格，长时间看屏幕不刺眼）和「白底黑字」（类似文档风格，截图可用）。勾选「时间戳」可以为每一条接收数据加上精确时间。注意时间戳以 rn 为帧边界——如果你收到的 Modbus 帧中间刚好有 0D 0A，时间戳会被错误插入到帧内部。所以 Modbus 调试时时间戳功能建议在 ASCII 模式下使用，Hex 模式下建议关闭。

发送区支持 ASCII 和十六进制两种输入格式。勾选「发送新行」自动在发送内容末尾添加 rn——调 AT 指令的模块（如 ESP8266、4G 模块）时必须勾上。快捷键 Ctrl+Enter 可直接发送。

「定时发送」功能：可以设置固定周期（毫秒级），软件自动按间隔循环发送发送区的内容。适合做老化测试——比如给 Modbus 从站连续发 24 小时读寄存器命令，看设备会不会通信中断。

「文件发送」功能：能把任意格式的文件（如 .bin 固件、.hex 升级包）按字节流通过串口发出去，带进度条和暂停/继续控制。IAP（In-Application Programming）串口升级固件时直接用它，不需要单独写个升级工具。

2.3 多条发送与指令管理

四条独立发送页面，每条页面有 10 条可编辑的发送指令（等于最多 40 条预置命令）。每条指令的发送格式（Hex/ASCII）、是否加新行、发送周期都可以单独配置。数字键盘 0~9 可以绑定到当前页面的第 1~10 条指令——适合需要快速响应控制的场景，比如智能车控制（按数字键 1 前进、2 后退、3 左转）。

指令集支持导出为 Excel 格式、也从 Excel 导入。项目交接时直接把你的所有测试指令导出成一个文件发给同事，他导入后就能用完全一样的命令调试。

三、协议传输模式——ATK-XCOM 的杀手锏

这是 ATK-XCOM 和普通串口助手的本质区别所在。大部分串口助手只是「你把字节发出去，有回应的就显示出来」。ATK-XCOM 的协议传输模式做了三件事：自动校验、自动超时重发、数据和帧的分离显示。

3.1 工作原理

协议传输的基本流程：你在发送区填入要发的实际数据（Payload），ATK-XCOM 自动在数据前后加上帧头和校验码，拼成完整的协议帧，通过串口发出去。接收端收到帧后，计算校验码，如果校验通过则返回确认帧（ACK），发送端收到 ACK 表示传输成功。如果在设定时间内没有收到 ACK，自动重发，最多重试配置的次数。

对于 Modbus RTU 来说用不到全套的 Send-Ack 机制（Modbus 本身就有自己的主从问答协议），但它支持四种校验算法，以及「显示原始帧」和「显示实际数据」分开的功能——这两个在 Modbus 调试中太实用了。

3.2 四种校验方式

在协议传输设置中选「CRC16」，ATK-XCOM 自动按 Modbus 标准多项式（0xA001）计算，结果低字节在前、高字节在后（小端序），完全符合 Modbus RTU 的 CRC 排序规则。你只需要输入除 CRC 之外的裸帧，软件替你加上两字节 CRC。

3.3 显示原始帧 vs 显示实际数据

接收区可以两个模式切换：

• 显示原始帧：接收到的完整字节流，包括帧头、地址、功能码、数据、校验码，全显示出来。用于排查帧结构问题——比如发现收到的字节数少了，可能是定时间隔太短被截断了。
• 显示实际数据：只显示经过校验后的有效数据载荷，所有帧头和校验码都被剥离。用于快速看数据内容——不需要在十六进制里找「数据在哪开始、校验在哪结束」。

Modbus 调试时这两个模式的切换是这样的：先用「显示原始帧」确认帧结构正确、校验码通过。确认无误后切换到「显示实际数据」，只关注寄存器的数值变化。

3.4 自动重发与超时配置

发送失败后的重试机制可配置三个参数：

• 超时时间（ms）：等待 ACK 的最大时间。对于 Modbus 从站，典型值设为 100~500ms 足够，取决于从站设备的响应速度。有些低速设备（老旧的 51 单片机跑 4800 波特率）可能需要设到 800ms 甚至更高。
• 重发次数：超时后自动重发的最大次数。设 0 表示不重发。一般设 3~5 次。
• 重发间隔（ms）：两次重发之间的间隔。这个值需要 > 超时时间，否则逻辑就乱了。对于 Modbus RTU 的场景，帧间隔必须 ≥ 3.5 字符时间（3.5 × 11 / 波特率），比如 9600 bps 就是约 4ms。

这些参数放在一个 GUI 面板上，比写代码配串口超时直观得多。关键是可以直观地看到「在第几次重发时收到了正确的 ACK」——如果每次都到第 3 次才成功，说明通信链路有不稳定的地方，要去排查线缆或干扰。

四、使用 ATK-XCOM 调试 Modbus RTU 的完整流程

步骤一：配置串口参数

打开 ATK-XCOM V3.0，选择对应的 COM 口。波特率设 9600（或设备实际波特率），数据位 8，停止位 1，校验位选无或偶校验——取决于你设备的具体配置。

点「打开串口」。如果线路正确、设备已上电，状态栏会显示串口已打开，收发字节数从 0 开始。

步骤二：构造 Modbus 查询帧

假如读从站地址 01 的保持寄存器 40001（地址 0x0000），读 1 个寄存器。裸帧（不含 CRC）是：

01 03 00 00 00 01

勾选「十六进制发送」，在发送区输入 010300000001。在「协议传输」设置中勾选 CRC16 校验，ATK-XCOM 会自动计算 CRC 并在帧末尾附加两字节（对于这个帧，CRC 是 0x840A，发出去的完整帧是 01 03 00 00 00 01 84 0A）。点发送。

步骤三：解析返回帧

设备正常响应时，ATK-XCOM 接收区会显示回来的十六进制数据。标准的响应帧格式是：

01 03 02 XX YY CRCL CRCH

其中 02 表示数据区的字节数（读 1 个寄存器就是 2 字节），XX YY 是寄存器值（高字节在前）。

如果返回的是：

01 83 02 CRCL CRCH

功能码变成了 0x83——这是原始功能码 0x03 的最高位被置为 1，加上异常码 0x02。Modbus 异常码 0x02 表示「非法数据地址」——你请求的寄存器地址在这个从站上不存在。

步骤四：利用多条发送管理常用 Modbus 命令

在「多条发送」区域建四个页面：

页面 1 —— 读取类命令

Article 1: 010300000001 → Read slave station 01 register 40001 (1)
Item 2: 010300000004 → Read from register 40001 of slave station 01~40004（4A)
Article 3: 0103000A0001 → Read slave station 01 register 40011 (1)
Item 4: 010100000008 → Read from station 01 coil 00001~00008（8A)

每个条目独立勾选「十六进制发送」和 CRC16 校验。

页面 2 —— 写入类命令

Article 1: 010600000001 → Write slave 01 register 40001=1
Item 2: 010600000000 → Write slave 01 register 40001=0
Article 3: 011000000001020001 → Write multiple registers for slave station 01，Starting from 0000，2byte，Value=0001

页面 3 —— 广播与诊断

Article 1: 000800000001 → Broadcast diagnosis(Sub function code 0001)，Restart communication)
Item 2: 00110000 → Broadcast to obtain slave station event counter

页面 4 —— 导出备份

全配置完，菜单 → 导出发送条目 → 存为 Excel 文件。以后换电脑直接用这个文件导入，所有命令一秒恢复。

五、ATK-XCOM vs 其他串口工具的定位

选工具的三个场景：

• 日常调试 Modbus RTU，只需收发和看数据 → ATK-XCOM。协议传输模式内置 CRC，多条发送管理方便，不需要写脚本。
• 需要自动化批量测试、自定义数据解析、和 TCP/MQTT 联调 → LLCOM。Lua 脚本的灵活性无可替代，但学习成本高。
• 只是偶尔用一次串口、发几条 AT 指令 → COMTool 或 SSCOM。轻量，不需要任何配置。

ATK-XCOM 的定位是「专业串口调试的工具箱」而不是「可编程万能工具」。它的设计哲学是把嵌入式工程师最常用的调试流程做成固定功能，让你不需要写代码就能跑。LLCOM 是把所有可编程能力开放给你，让你想干嘛就干嘛——但代价是你要会写 Lua。

两个工具配合用才是最合理的：ATK-XCOM 搞定日常的收发和校验，LLCOM 搞定需要自动化重复操作的任务。

六、常见问题

CRC16 校验结果和手动算的不一致？ 确认两件事：1) 多项式是否正确——Modbus RTU 用的是 0xA001（不是 0x8005，那是 IBM CRC-16 的正向多项式）。2) 初始化是否为 0xFFFF。ATK-XCOM 内置的 CRC16 是严格按照 Modbus 协议实现的，正确结果可以用在线 CRC 计算器交叉验证。

收不到从站响应？ 三查：1) 波特率和校验位是否匹配。2) 从站地址是否正确（注意默认地址可能是 1 也可能是 247，每个厂商不一样）。3) 设备是否上电——这在现场是最常被忽略的，很多人插上 USB 转 485 以为设备就有电了，实际设备需要独立的 DC 供电。

时间戳不显示？ ATK-XCOM 的时间戳以 rn 为断帧标志。如果收到的数据是纯 Modbus RTU 二进制帧、不包含 0D 0A，时间戳功能不会触发。建议在 Hex 接收模式下关闭时间戳，或确认对方数据流确实包含换行符。

文件发送到一半停了？ 检查目标设备的接收缓冲区是否足够。文件发送是连续字节流，如果设备处理速度跟不上（比如每接收一个字节就要写 Flash 并等待完成），发送端不会自动降速。解决方案是降低发送波特率，或者把文件拆成小块，用多条发送的定时功能分片发送。

ATK-XCOM 没有什么炫酷的新概念，它的每个功能都来自嵌入式工程师在调试现场的真实需求——协议传输是因为设备一应答就出错又不知道错在哪，多条发送是因为十几条 AT 指令来回手打太折磨人，自定义波特率是因为总有一些非标设备。这就是正点原子作为「从开发板里长出来的工具团队」和「纯软件工具团队」最大的区别——后者是设计出来的，前者是磨出来的。

有问题再聊。