- 1. 一、软件怎么装
- 2. 二、基础Function速览
- 3. 2.1 串口设置
- 4. 2.2 显示与send
- 5. 2.3 多条send与指令管理
- 6. 三、协议传输模式——ATK-XCOM 的杀手锏
- 7. 3.1 工作原理
- 8. 3.2 四种校验方式
- 9. 3.3 显示原始帧 vs 显示实际data
- 10. 3.4 自动重发与超时配置
- 11. 四、使用 ATK-XCOM debug Modbus RTU 的完整流程
- 12. 步骤一：配置Serial port parameters
- 13. 步骤二：构造 Modbus 查询帧
- 14. 步骤三：Parse返回帧
- 15. 步骤四：利用多条send管理常用 Modbus 命令
- 16. 五、ATK-XCOM vs 其他串口Tools的定位
- 17. 六、Frequently Asked Questions
- 18. Serial Port DebuggingAssistant软件 ATK-XCOM V3.0
来源：Modbus Chinese Network（modbus.cn） —— China leadingModbus通信协议技术社区
本文：Serial Port DebuggingAssistant软件 ATK-XCOM V3.0：从基础收发到 Modbus protocol传输的完整指南 · Author：modbus技术团队 · 发布于 2026-07-01
摘要：ATK-XCOM V3.0 由正点原子（ALIENTEK）开发，是国内嵌入式开发圈使用最广的串口Debug Tools之一。本文不仅覆盖其核心Function，更深入讲解它的协议传输模式——自动超时重发、checksum/异或/CRC8/CRC16 四种校验、data帧与实际data的分离显示——这些Function让 ATK-XCOM 在 Modbus RTU debugScene中比普通串口Assistant高出一个量级。附带完整的 Modbus debugOperation指南和同类Tools对比。关键词：ATK-XCOM、正点原子、Serial Port DebuggingAssistant、协议传输、Modbus RTU debug、CRC16、checksum。
debug串口这件事，说简单也简单——找个串口Assistant，选对 COM 口和Baud rate，发个hexadecimal帧，看回来啥。说难也难——当你的帧发出去，设备回了，但你不知道回来的data是不是对的，不知道丢没丢帧，不知道中间那两byte到底是不是正确的校验码。
ATK-XCOM V3.0 是正点原子团队开发的串口Debug Tools。正点原子在国内嵌入式圈的影响力不用多说——STM32 开发板、ESP32 模块、RT-Thread Tutorial，基本上学嵌入式的人都用过他们的东西。ATK-XCOM 是他们内部Debug Tools的外化版，Function构建来自真实的开发Scene而非凭空设计。
一、软件怎么装
developer：正点原子（ALIENTEK），国内专业的嵌入式开发解决方案提供商。长期专注于为工程师、学生和爱好者提供开发板、模块和配套Tools。
system要求：Windows 7 及以上，32/64 位均支持。实测在 Windows 10 和 Windows 11 上运行稳定，CH340、CP2102、FT232 等常见 USB 转串口芯片均正常识别。
二、基础Function速览
2.1 串口设置
打开软件后自动扫描所有可用串口，在串口下拉列表中可以看到对应的串口名称和详细信息（如 COM3: USB-SERIAL CH340）。常见的 CH340 芯片支持热插拔——USB 插上后点击refresh即可出现，拔掉后自动消失。部分老旧驱动可能需要手动Close the serial port再打开。
Baud rate范围：预设 1200 ~ 1382400 bps，覆盖了所有标准速率。需要非标Baud rate（如 750000、921600）时，在串口Close状态下点击「Customization」button，直接Enter numerical value。前提是你的 USB 转串口芯片和对方设备的 UART 都能支持这个速率——STM32 的 USART 在 72MHz 时钟下支持的非标Baud rate范围很窄，不是随便输个数字就能稳的。
stop bit：1、1.5、2 三种。data bit：5、6、7、8 四位。check digit：无校验、odd parity、even parity。Modbus RTU 的标准配置：8 data bit、1 stop bit、even parity或无校验。
2.2 显示与send
receive区支持两种显示模式：hexadecimal和 ASCII，可实时Switch。两种配色方案：经典的「黑底绿字」（类似终端风格，长time看屏幕不刺眼）和「白底黑字」（类似Document风格，截图可用）。勾选「time戳」可以为每一条receivedata加上精确time。注意time戳以 rn 为帧边界——如果你收到的 Modbus 帧中间刚好有 0D 0A，time戳会被Error插入到帧内部。所以 Modbus debug时time戳Function建议在 ASCII 模式下使用，Hex 模式下建议Close。
Sending Area支持 ASCII 和hexadecimal两种Input format。勾选「send新行」自动在send内容末尾添加 rn——调 AT 指令的模块（如 ESP8266、4G 模块）时必须勾上。快捷键 Ctrl+Enter 可直接send。
「定时send」Function：可以设置固定周期（毫秒级），软件自动按间隔loop sendingSending Area的内容。适合做老化测试——比如给 Modbus 从站连续发 24 小时读register命令，看设备会不会通信中断。
「文件send」Function：能把任意format的文件（如 .bin 固件、.hex 升级包）按byte流通过串口发出去，带progress bar和暂停/继续控制。IAP（In-Application Programming）串口升级固件时直接用它，不需要单独写个升级Tools。
2.3 多条send与指令管理
四条独立send页面，每条页面有 10 条可Edit的send指令（等于最多 40 条预置命令）。每条指令的sendformat（Hex/ASCII）、是否加新行、send周期都可以单独配置。数字键盘 0~9 可以绑定到当前页面的第 1~10 条指令——适合需要快速Response控制的Scene，比如智能车控制（按数字键 1 前进、2 后退、3 左转）。
指令集支持export为 Excel format、也从 Excel 导入。项目交接时直接把你的所有测试指令export成一个文件发给同事，他导入后就能用完全一样的命令debug。
三、协议传输模式——ATK-XCOM 的杀手锏
这是 ATK-XCOM 和普通串口Assistant的本质区别所在。大部分串口Assistant只是「你把byte发出去，有回应的就显示出来」。ATK-XCOM 的协议传输模式做了三件事：自动校验、自动超时重发、data和帧的分离显示。
3.1 工作原理
协议传输的基本流程：你在Sending Area填入要发的实际data（Payload），ATK-XCOM 自动在data前后加上帧头和校验码，拼成完整的协议帧，通过串口发出去。receive端收到帧后，计算校验码，如果校验通过则返回Confirm帧（ACK），send端收到 ACK 表示传输成功。如果在设定time内没有收到 ACK，自动重发，最多重试配置的次数。
对于 Modbus RTU 来说用不到全套的 Send-Ack 机制（Modbus 本身就有自己的主从问答协议），但它支持四种校验算法，以及「显示原始帧」和「显示实际data」分开的Function——这两个在 Modbus debug中太实用了。
3.2 四种校验方式
| 校验方式 | Length | 算法简述 | 适用Scene |
|---|---|---|---|
| checksum（Checksum） | 1 byte | 所有databyte累加，取低 8 位 | 简单协议、Customization帧 |
| 异或（XOR） | 1 byte | 所有databyte连续异或 | NMEA 0183（GPS）、部分传感器 |
| CRC8 | 1 byte | 8 位循环冗余校验，多项式可配 | Dallas 1-Wire、SMBus |
| CRC16 | 2 bytes | 16 位循环冗余校验，查表法实现 | **Modbus RTU**（多项式 0xA001） |
在协议传输设置中选「CRC16」，ATK-XCOM 自动按 Modbus 标准多项式（0xA001）计算，结果低byte在前、高byte在后（小端序），完全符合 Modbus RTU 的 CRC 排序Rules。你只需要输入除 CRC 之外的裸帧，软件替你加上两byte CRC。
3.3 显示原始帧 vs 显示实际data
receive区可以两个模式Switch：
- 显示原始帧：receive到的完整byte流，包括帧头、address、function code、data、校验码，全显示出来。用于排查帧结构问题——比如发现收到的byte count少了，可能是定time隔太短被截断了。
- 显示实际data：只显示经过校验后的effectivedata载荷，所有帧头和校验码都被剥离。用于快速看data内容——不需要在hexadecimal里找「data在哪开始、校验在哪End」。
Modbus debug时这两个模式的Switch是这样的：先用「显示原始帧」Confirm帧结构正确、校验码通过。Confirm无误后Switch到「显示实际data」，只关注register的numerical value变化。
3.4 自动重发与超时配置
send失败后的重试机制可配置三个参数：
- 超时time（ms）：等待 ACK 的最大time。对于 Modbus 从站，典型值设为 100~500ms 足够，取决于从站设备的Response速度。有些低速设备（老旧的 51 单片机跑 4800 Baud rate）可能需要设到 800ms 甚至更高。
- 重发次数：超时后自动重发的最大次数。设 0 表示不重发。一般设 3~5 次。
- 重发间隔（ms）：两次重发之间的间隔。这个值需要 > 超时time，否则逻辑就乱了。对于 Modbus RTU 的Scene，帧间隔必须 ≥ 3.5 字符time（3.5 × 11 / Baud rate），比如 9600 bps 就是约 4ms。
这些参数放在一个 GUI 面板上，比写代码配串口超时直观得多。关键是可以直观地看到「在第几次重发时收到了正确的 ACK」——如果每次都到第 3 次才成功，说明通信链路有不稳定的地方，要去排查线缆或干扰。
四、使用 ATK-XCOM debug Modbus RTU 的完整流程
步骤一：配置Serial port parameters
打开 ATK-XCOM V3.0，选择对应的 COM 口。Baud rate设 9600（或设备实际Baud rate），data bit 8，stop bit 1，check digit选无或even parity——取决于你设备的具体配置。
点「Open the serial port」。如果线路正确、设备已上电，状态栏会显示串口已打开，收发byte count从 0 开始。
步骤二：构造 Modbus 查询帧
假如读slave address 01 的保持register 40001（address 0x0000），读 1 个register。裸帧（不含 CRC）是：
01 03 00 00 00 01勾选「hexadecimalsend」，在Sending Area输入 010300000001。在「协议传输」设置中勾选 CRC16 校验，ATK-XCOM 会自动计算 CRC 并在帧末尾附加两byte（对于这个帧，CRC 是 0x840A，发出去的完整帧是 01 03 00 00 00 01 84 0A）。点send。
步骤三：Parse返回帧
设备正常Response时，ATK-XCOM receive区会显示回来的hexadecimaldata。标准的Response帧format是：
01 03 02 XX YY CRCL CRCH其中 02 表示data area的byte count（读 1 个register就是 2 bytes），XX YY 是register value（高byte在前）。
如果返回的是：
01 83 02 CRCL CRCHfunction code变成了 0x83——这是原始function code 0x03 的最高位被置为 1，加上Exception Code 0x02。Modbus Exception Code 0x02 表示「Illegal data address」——你Request的register address在这个从站上does not exist。
步骤四：利用多条send管理常用 Modbus 命令
在「多条send」区域建四个页面：
页面 1 —— 读取类命令
条目1: 010300000001 → 读从站01register40001（1个）
条目2: 010300000004 → 读从站01register40001~40004（4个）
条目3: 0103000A0001 → 读从站01register40011（1个）
条目4: 010100000008 → 读从站01线圈00001~00008（8个）每个条目独立勾选「hexadecimalsend」和 CRC16 校验。
页面 2 —— 写入类命令
条目1: 010600000001 → 写从站01register40001=1
条目2: 010600000000 → 写从站01register40001=0
条目3: 011000000001020001 → 写从站01多个register，start0000，2byte，值=0001页面 3 —— 广播与诊断
条目1: 000800000001 → 广播诊断（子function code0001，重启通信）
条目2: 00110000 → 广播获取从站事件计数器页面 4 —— export备份
全配置完，菜单 → exportsend条目 → 存为 Excel 文件。以后换电脑直接用这个文件导入，所有命令一秒恢复。
五、ATK-XCOM vs 其他串口Tools的定位
| 对比维度 | ATK-XCOM V3.0 | LLCOM | SSCOM | COMTool |
|---|---|---|---|---|
| 开发方 | 正点原子（国内） | chenxuuu 个人开源 | 个人 | 个人开源 |
| free | 是 | 是 | 是 | 是 |
| 脚本化 | 不支持 | Lua 5.3 脚本引擎 | 不支持 | 有限支持 |
| 协议传输 | 支持（帧头/校验/ACK/超时重发） | 不支持（需自己写 Lua） | 不支持 | 不支持 |
| CRC/校验 | 内置 4 种（checksum/XOR/CRC8/CRC16） | 需自己写 Lua | 不支持 | 不支持 |
| 多条send | 4 页×10 条+快捷键 | 10 页不限条数 | 不支持 | 支持 |
| Baud rate上限 | 1382400 | 受驱动限制 | 受驱动限制 | 受驱动限制 |
| GUI 风格 | 经典绿底黑字 | 现代白色 | 老式 Windows | 现代 |
| Download方式 | 百度网盘+官方 | GitHub+MS Store | 各Download站 | GitHub |
选Tools的三个Scene：
- 日常debug Modbus RTU，只需收发和看data → ATK-XCOM。协议传输模式内置 CRC，多条send管理方便，不需要写脚本。
- 需要自动化批量测试、CustomizationdataParse、和 TCP/MQTT 联调 → LLCOM。Lua 脚本的灵活性无可替代，但学习成本高。
- 只是偶尔用一次串口、发几条 AT 指令 → COMTool 或 SSCOM。轻量，不需要任何配置。
ATK-XCOM 的定位是「专业Serial Port Debugging的Tools箱」而不是「可编程万能Tools」。它的设计哲学是把嵌入式工程师最常用的debug流程做成固定Function，让你不需要写代码就能跑。LLCOM 是把所有可编程能力开放给你，让你想干嘛就干嘛——但代价是你要会写 Lua。
两个Tools配合用才是最合理的：ATK-XCOM 搞定日常的收发和校验，LLCOM 搞定需要自动化重复Operation的任务。
六、Frequently Asked Questions
CRC16 校验结果和手动算的不一致？ Confirm两件事：1) 多项式是否正确——Modbus RTU 用的是 0xA001（不是 0x8005，那是 IBM CRC-16 的正向多项式）。2) 初始化是否为 0xFFFF。ATK-XCOM 内置的 CRC16 是严格按照 Modbus protocol实现的，正确结果可以用在线 CRC 计算器交叉验证。
收不到从站Response？ 三查：1) Baud rate和check digit是否匹配。2) slave address是否正确（注意默认address可能是 1 也可能是 247，每个厂商不一样）。3) 设备是否上电——这在现场是最常被忽略的，很多人插上 USB 转 485 以为设备就有电了，实际设备需要独立的 DC 供电。
time戳不显示？ ATK-XCOM 的time戳以 rn 为断帧标志。如果收到的data是纯 Modbus RTU binary帧、不包含 0D 0A，time戳Function不会触发。建议在 Hex receive模式下Closetime戳，或Confirm对方data流确实包含换行符。
文件send到一半停了？ 检查目标设备的receive缓冲区是否足够。文件send是连续byte流，如果设备处理速度跟不上（比如每receive一个byte就要写 Flash 并等待Complete），send端不会自动降速。解决方案是降低sendBaud rate，或者把文件拆成小块，用多条send的定时Function分片send。
ATK-XCOM 没有什么炫酷的新概念，它的每个Function都来自嵌入式工程师在debug现场的真实需求——协议传输是因为设备一应答就出错又不知道错在哪，多条send是因为十几条 AT 指令来回手打太折磨人，CustomizationBaud rate是因为总有一些非标设备。这就是正点原子作为「从开发板里长出来的Tools团队」和「纯软件Tools团队」最大的区别——后者是设计出来的，前者是磨出来的。
有问题再聊。
星耀member
发表回复