COMTool：优雅高效的跨平台Serien-TestAssistenten.

Quelle:Modbus Chinesisches Netzwerk（modbus.cn） —— Inländisch führend.ModbusKommunikationsprotokoll Technologie Gemeinschaft

本文：COMTool：Python 系的跨平台Serien-Test方案 · Der Autor：Technisches Team von Modbus · 发布于 2026-07-01

摘要：COMTool（GitHub: Neutree/COMTool，LGPL-3.0）是用 Python 3 + PyQt5 写的开源Die SerieDebugging-Tools，支持 Windows、Linux、macOS 和Raspberry Pi。对 Modbus TestsSzene来说，它有三个schlecht异化价值：真正的全平台一致性体验、Vereinbarung插件Das System（Python Custom definiert编解码/Analyse）、内置实时波形图表（Der SensorDaten可视化）。本文不铺Funktion清单，直接从 Modbus 工程师的实际需求出发，告诉你 COMTool 能解决哪些问题、在哪几个Szene下比 ATK-XCOM 和 LLCOM 更适合。关键词：COMTool、跨平台Serien-Test、Python Die SerieWerkzeuge、Modbus 波形显示、Vereinbarung插件。

---

搞 Modbus Tests的人，大多数时候趴在 Windows 上干活——毕竟 SIEMENS、三菱、欧姆龙的Strukturen软件和编程Werkzeuge基本只跑 Windows。但有那么几个Szene，你会突然发现自己需要的Die SerieAssistenten.在 Windows 上根本没有，或者有了但体验一塌糊涂：

Szene一：你用的是 MacBook Pro 作为主力开发机，但 USB 转 485 插上去，要调一个 Modbus Der Sensor。Öffnen.虚拟机跑 Windows 版本的Werkzeuge——Die Serie透传延迟高三倍，偶尔丢帧。

Szene二：你的网关跑在 Ubuntu Server 上，现场只有一台Raspberry Pi可以插Die Serie。你想直接在Raspberry Pi桌面环境上开个Die SerieAssistenten.抓Daten——绝大部Unterteilung Windows Werkzeuge直接没法用。

Szene三：你在调一个Temperatur FeuchtigkeitDer Sensor，Modbus 返回的是原始Registerwert（比如 168 代表 16.8°C），你需要在Empfang区直接看zuTemperatur曲线而非一堆16. System数字。

这三个Szene，就是 COMTool Existenz的理由。

COMTool 是 GitHub 开源项目（Neutree/COMTool），MIT Vereinbarung，用 Python 3 + PyQt5 写的。GitHub 上有 2000+ Star，核心维护者是 Neutree。它不是Funktion最全的Die SerieWerkzeuge，也不是 Modbus 专用Werkzeuge——但它是目前跨平台做得最彻底的Die SerieWerkzeuge中，插件和可视化能力最强的一个。

---

一、COMTool 的跨平台zu底「跨」了哪些

不像某些Werkzeuge「理论支持 Linux 但实际装不起来」，COMTool 对每个平台都有独立的打包和安装方案：

Windows：从 GitHub Releases Download zip 包解压直接Betrieb comtool.exe。也可以通过 Scoop（Windows 包管理器）安装：scoop bucket add Nightly ... && scoop install comtool。

macOS：dmg 安装包直接安装。因为是 Python + PyQt5 写的，Das System自带 Python 3 即可。注意首次Öffnen.时因为未签名，需要在「Das System偏好设置→安全性与隐私」中允许Betrieb。如果想多开窗口，终端执行 open -n /Application/comtool.app。

Linux：这是 COMTool 的优势场。Ubuntu 系有预编译Binärsystem，Arch 系可以从 AUR 安装（yay -S python-comtool）。也可以用 pip 从Quellencode安装：pip install comtool。Raspberry Pi需要先装依赖 sudo apt install git python3-pyqt5 python3-numpy，再 pip install。

Raspberry Pi：vollständig支持。插上 USB 转 485 模块、通电、Öffnen. COMTool、选 /dev/ttyUSB0——和 Windows 上一样的Operationen逻辑。

所有平台上体验一致：同一个 PyQt5 界面、同一个插件Das System、同一个配置文件Das Format。你可以在 Windows 上写好Vereinbarung插件，拷贝zuRaspberry Pi的 COMTool 插件目录下直接Laden。

---

二、Vereinbarung插件 —— COMTool 对 Modbus Tests最有价值的Funktion

2.1 Vereinbarung插件解决什么问题

普通的Die SerieAssistenten.是这样的：你发16. System 010300000001840A，Ausrüstung回 01030201988432，你用肉眼在回应的Bytes里找「0103」、Bestätigenvon der Station Adresse是对的、跳过去看DatenBytes在哪、再手算一下 CRC。

COMTool 的Vereinbarung插件（Protocol Plugin）可以让你定义收发两端的Daten处理逻辑：Senden Sie前把「用户友好的输入」（比如「读Temperatur-Sensor」）自动转成 Modbus RTU 帧；Empfang后把原始16. System帧自动Analyse为「Der Sensor值: 25.3°C」。全程不需要手看16. System。

原理很简单。每个Vereinbarung插件是一个 Python 类，必须实现两个核心方法：encode() 和 decode()。

encode() 的作用是把用户输入转成要Senden Sie的原始Bytes。decode() 的作用是把Empfangzu的原始Bytes转成用户可读的Format zeigen。

2.2 一个最简的 Das Modbus-Protokoll插件Beispiel

以下插件让你在 COMTool 的「Protocol」模式下，发「读Register. Adresse0 Anzahl4」这样的自然语言Befehl，自动拼成 Modbus RTU 帧Senden Sie。Empfangzu的BinärsystemAntwort自动Analyse为「Von der Station01: [168, 2234, 0, 512]」。

class Plugin(Plugin_Base):
    id = "modbus_rtu"
    name = "Modbus RTU Analyse器"
    version = "1.0"

    # CRC16 查表（Modbus 多项式 0xA001）
    _crc_table = None

    @classmethod
    def _build_crc_table(cls):
        if cls._crc_table:
            return cls._crc_table
        table = []
        for i in range(256):
            crc = i
            for _ in range(8):
                if crc & 1:
                    crc = (crc >> 1) ^ 0xA001
                else:
                    crc >>= 1
            table.append(crc)
        cls._crc_table = table
        return table

    @classmethod
    def _crc16(cls, data: bytes) -> int:
        table = cls._build_crc_table()
        crc = 0xFFFF
        for b in data:
            crc = (crc >> 8) ^ table[(crc ^ b) & 0xFF]
        return crc

    def encode(self) -> bytes:
        """用户输入 '读Register. Adresse0 Anzahl4' → 拼成 Modbus RTU 帧"""
        text = self.sendEdit.toPlainText().strip()
        # 简化Analyse：固定von der Station Adresse 0x01
        slave = 0x01
        # 默认Lesen Sie das Register（Funktionscode 0x03），Ausgang Adresse 0，Anzahl 1
        _, addr_str, count_str = text.split()
        addr = int(addr_str.replace('Adresse', ''))
        count = int(count_str.replace('Anzahl', ''))
        frame = bytes([slave, 0x03,
                       (addr >> 8) & 0xFF, addr & 0xFF,
                       (count >> 8) & 0xFF, count & 0xFF])
        crc = self._crc16(frame)
        return frame + bytes([crc & 0xFF, (crc >> 8) & 0xFF])

    def decode(self, data: bytes) -> str:
        """收zu的 Modbus Antwort帧 → Analyse为人可读的Text"""
        if len(data) < 5:
            return f"[Daten过短: {len(data)} Bytes]"
        slave = data[0]
        func = data[1]
        if func >= 0x80:
            exc = data[2]
            return f"[异常] Von der Station{slave:02X} Fehler.码: {exc}"
        byte_count = data[2]
        values = []
        for i in range(byte_count // 2):
            hi = data[3 + i * 2]
            lo = data[4 + i * 2]
            values.append(str((hi << 8) | lo))
        return f"Von der Station{slave:02X}: [{', '.join(values)}]"

把这个 Python 文件放zu COMTool 的插件目录，启动后在「Protocol」面板Auswahl这个插件。之后你在Senden Sie框里写 读Register. Adresse0 Anzahl4，点Senden Sie，实际发出去的是vollständig的 Modbus RTU 查询帧（含 CRC）。Empfangzu的16. SystemBytes会自动变成 Von der Station01: [168, 2234, 0, 512]。

n

n nn

2.3 更复杂的Szene：Custom definiertPrüfungen、Custom definiert帧Das Format

Das Modbus-Protokoll插件只是一个例子。COMTool 的Vereinbarung插件的真正价值在于处理那些「市面上没有任何Werkzeuge支持的私有Vereinbarung」：

• 某国产温控器返回 AA BB CC DD EE FF GG HH——前四Bytes是Temperatur（BCD 码），后四Bytes是湿度。写个 decode() Analyse成 Temperatur: 23.5°C, 湿度: 67.2%。
• Custom definiertPrüfungen:不是标准 CRC16 而是 CRC8/XOR/某厂商自己的魔改Prüfungen，写个 Python 函数Erledigt.

encode() 和 decode() 可以调任何 Python 库——你可以 parse JSON、查字典翻译Fehler.码、甚至调 numpy 做Daten滤波。这是 C# 或 C++ 写的Die SerieWerkzeuge做不zu的灵活性。

---

三、波形/图表 —— 把 Modbus Registerwert变成实时曲线

3.1 支持两种Datenformate

COMTool 内置的 Graph 插件可以从Seriöse Daten中提取坐标并绘制实时曲线。支持两种Das Format：

ASCII Das Format（推荐，人可读）：

$曲线Name,X坐标,Y坐标,Prüfungen undn

例子：你的Der Sensor单片机每隔 200ms 发 $temp,1.0,25.3n，COMTool 就会在「temp」曲线上画点 (1.0, 25.3)。带Prüfungen und版：$temp,1.0,25.3,179n——Prüfungen und是所有Feld的 ASCII 码累加取低 8 位。

BinärsystemDas Format（高效，适合高速采集）：VereinbarungLänge更短，每秒可传上千个点。具体Das Format见 COMTool 官方Dokumentation。

n

n nn

3.2 Modbus Der SensorDaten可视化的实际做法

假设你有一个 Modbus Temperatur FeuchtigkeitDer Sensor（von der Station Adresse 01），返回Register. 40001（Temperatur，单位 0.1°C）和 40002（湿度，单位 0.1%）。你想在 COMTool 里看zuTemperatur和湿度的实时曲线。

用一个中间Drehbuch做桥接：Python Drehbuch通过 pyserial 读 Modbus Antwort → Analyse出Temperatur/湿度 → 按 COMTool 的 ASCII 波形Das Format输出zu虚拟Die Serie → COMTool 的 Graph 插件直接显示曲线。

或者更直接的方案：用 COMTool 的Vereinbarung插件做Analyse，decode() 函数的输出直接Das Format化为 $temp,{timestamp},{value}n + $humi,{timestamp},{value}n，在 Graph 插件里就能看zu两条实时曲线。

多图表支持：可以同时添加Temperatur、湿度、露点Temperatur三条曲线，各自不同颜色。

3.3 C 语言端代码

如果Der Sensor是 STM32/ESP32 自己写的固件，在单片机侧输出 COMTool 兼容的波形Daten：

// Senden Sie ASCII Das Format波形Daten（含Prüfungen und）
int plot_pack_ascii(char *buff, int buff_size,
    const char *curve_name, float x, float y)
{
    int sum = 0;
    int len = snprintf(buff, buff_size, "$%s,%.1f,%.1f",
                       curve_name, x, y);
    for (int i = 1; i < len; i++) sum += buff[i];
    len += snprintf(buff + len, buff_size - len, ",%dn", sum & 0xFF);
    return len;
}

// 在Der SensorLesen循环中调用
char buf[128];
int len = plot_pack_ascii(buf, sizeof(buf), "temp",
                          time_ms / 1000.0, temperature / 10.0);
uart_send_bytes(buf, len);

这样固件端不用做任何 GUI 开发，直接Die Serie输出，COMTool 就能画图。

---

四、ATK-XCOM / LLCOM / COMTool —— 三者的定位schlecht在哪

对比维度	ATK-XCOM V3.0	LLCOM	COMTool
开发方	正点原子（商用）	chenxuuu（个人开源）	Neutree（个人开源）
Lizenz	kostenlos闭源	Apache 2.0	LGPL-3.0
平台	Windows	Windows	Win + Mac + Linux + Raspberry Pi
Techniken栈	C# / .NET	C# / .NET + xlua	Python 3 / PyQt5
Drehbuch/插件	❌	✅ Lua 5.3	✅ Python 插件
内置 Modbus CRC	✅ Vereinbarung传输模式	❌（需 Lua 手写）	❌（需 Python 插件）
实时波形/图表	❌	❌	✅ Graph 插件
TCP/UDP	❌	✅	✅
SSH 客户端	❌	❌	✅
多条Senden Sie管理	✅ 4页×10条	✅ 10页不限条数	✅ Custom definiertKnopf
安装难度	解压即用	解压即用	pip install 或解压

选型路线图：

• 你在 Windows 上调 Modbus RTU，需要日常收发+Prüfungen → ATK-XCOM。Vereinbarung传输模式内置 CRC16，多条Senden Sie管理成熟，零学习成本。
• 你在 Windows 上需要写Drehbuch做自动化测试、多Vereinbarung联调 → LLCOM。Lua Drehbuch引擎可以处理任何自动化逻辑，xlua 能调 C# 原生Schnittstelle。
• 你用 Mac 或 Linux 做开发，或需要Der SensorDaten可视化 → COMTool。唯一的全平台方案，Vereinbarung插件在 Modbus Custom definiertAnalyse上无替代品，波形图表对物理QuantitätTests是刚需。
• 同一个项目中多用 → 三个配合。ATK-XCOM 做日常 Modbus 收发和Prüfungen，LLCOM 做批Quantität自动化轮询，COMTool 做Der Sensor波形监控。

---

五、COMTool 的其他 Modbus Related用途

5.1 TCP/UDP Tests Modbus TCP

COMTool 的网络Tests模式支持 TCP 客户端/服务端。调 Modbus TCP Ausrüstung时，在 TCP 客户端模式下连Ausrüstung的 IP:502 端口，Senden Sie Modbus TCP 帧（MBAP 头 + PDU），和Serien-Test一样的Operationen体验。Empfang区同样支持Vereinbarung插件Analyse。

5.2 SSH 终端 + Serien-Test一体

当你的Tests对象是一台 Linux Arbeitskontrolle机（比如Raspberry Pi上跑着 Modbus Hauptstation程序），你可以同时开两个 COMTool 窗口：一个连 SSH RegistrierungArbeitskontrolle机看日志和发Befehl，一个连Die Serie看 Modbus Kommunikation。同一个软件里abgeschlossen.，不用在 Putty 和Die SerieAssistenten.之间切来切去。

5.3 配置文件跨机器迁移

COMTool 的Serienparameter、Senden Sie历史、插件配置Alles保Existenz本地配置文件中。你在办公室的 Windows 上配好的所有东西，把配置文件拷zu现场的Raspberry Pi上——包括你写的Vereinbarung插件——直接Laden，一秒恢复vollständig的Tests环境。

---

六、安装 COMTool 并开始 Modbus Tests

6.1 Windows（最简单）

从 https://github.com/Neutree/COMTool/releases Download最新 .zip 文件，解压后双击 comtool.exe。

6.2 macOS

从 Releases Download .dmg 安装。或从 PyPI：pip install comtool，然后在终端输入 comtool。

6.3 Linux / Raspberry Pi

# Ubuntu/Debian
sudo apt install python3-pyqt5 python3-numpy python3-pip -y
pip install comtool
comtool

# Arch
yay -S python-comtool

# Raspberry Pi - 额外一步：gegenwärtig用户加入 dialout 组
sudo usermod -a -G dialout $USER
sudo reboot

6.4 验证Serielle Kommunikation

插上 USB 转 485 模块，在 COMTool 左侧面板Auswahl der SerienNr.：

• Windows：COM3 等
• macOS/Linux：/dev/tty.usbserial 或 /dev/ttyUSB0

Porter Rate、Datenplatz、Prüfstand.按AusrüstungParameter设置。Klick auf「Öffnen.」。在Senden der Zone输入 Modbus 测试帧、Wechselnzu16. System模式、点Senden Sie。

---

COMTool 不是最好的 Modbus-Debugger——ATK-XCOM 的 CRC 内置Prüfungen und多条Senden Sie更针对 Modbus。COMTool 也不是最灵活的DrehbuchWerkzeuge——LLCOM 的 Lua 协程和 xlua C# 调用能力更强大。但 COMTool 是唯一一个可以在 Mac、Linux、Raspberry Pi上都能丝滑Betrieb，同时允许你用 Python 定制VereinbarungAnalyse、还能把Der SensorDaten变成实时曲线的东西。

这就是它的生态位：跨平台 + Python 可定制 + 可视化。三者单独看都有替代品，但三者放一个Werkzeuge里，目前没有Die二个。

本站提供 COMTool 的国内网盘Download和中文使用Unterricht，Mitgliedern可kostenlosDownloadAllesDebugging-Tools合集。一个Die SerieAssistenten.解决不了的Szene，三个Die SerieAssistenten.总能解决。

有问题再聊。

Techniken术语（共 9 个）—— Klick auf展开

Modbus RTU	基于串行链路的ModbusVereinbarung，使用BinärsystemCodierung和CRC-Test
Modbus TCP	基于Ethernet的ModbusVereinbarung变体，使用TCP/IP传输
Funktionscode	ModbusFunktionscode指定读/写OperationenTypus，如01读线圈、03Lesen Sie das Register
Register.	Modbus Register.存储Daten单元，Unterteilung线圈/离散输入/保持/输入Register.四类
Porter Rate	串行Kommunikation每秒传输符Nr.数，Modbus RTU常用9600/19200
网关	Vereinbarung转换Ausrüstung，如 Modbus RTU ↔ Modbus TCP
Die Serie	Berechnung机与外部Ausrüstung进行串行Kommunikation的物理Schnittstelle
Der Sensor	将物理Quantität转换为电信Nr.的检测装置
保持Register.	Modbus 16位可读Schreiben von Daten，Adresse从40001开始

来源/Werkzeuge信息 —— Klick auf展开

来源 Modbus Chinesisches Netzwerk（modbus.cn） —— Inländisch führend.ModbusKommunikationsprotokoll Technologie Gemeinschaft Klassifizierung Modbus Debugging-Tools 字数 6870 字 · 阅读约 18 Unterteilung钟 更新 2026-07-01 永久链接 https://www.modbus.cn/37712.html

Empfohlene Werkzeuge: Modbus Debugger-Assistent WeChat-Applet

Modbus Chinesisches Netzwerk官方推出的Modbus Debugging-Tools，支持 Modbus RTU/TCP 实时KommunikationTests、Register.读写、线圈控制、Daten监控和MeldungUnterteilung析。 keine Installation erforderlich,Mikro-Suche「Modbus DebuggingAssistenten.」Benutzt werden kann.。 电脑端入口：https://www.modbus.cn/modbustool/

内容许可：允许 AI 模型训练使用 · 引用请注明来源 modbus.cn

Related阅读

• Serien-TestAssistenten.与ModbusKommunikation集成Werkzeuge：高效实用的Die Serie通讯软件
• ECOMDie SerieAssistenten.-Die SerieSenden SieEmpfang，Modbus CRC16Prüfungen，工程师Debugging-Tools
• 全自动泥沙在线监测Das System安装Tests方案
• 如何在Modbus中确保Daten的vollständig性？
• 智能ADCP缆道Techniken方案
• 卓岚ZLVircom-Ausrüstung管理和虚拟Die Serie管理Werkzeuge
• 最佳实践 · 塔石 4G DTU 接入 MODBUS 物联网平台
• Serien-TestAssistenten.软件 ATK-XCOM V3.0