Serial · Protocol · AI
把串口的字节流,
切成能读懂的链路
每个字节的到达时刻、每一帧的字段、每个校验的结果,都在一张表里。 再让 AI 基于这些真实字段给结论。
8ms
接收聚合节拍,高速数据下不卡
0丢包
128 KB 连续写入实测
54ms
1 MB 经远程中继转发
20万行
环形日志缓冲
Core
四件事,各自解决一个问题
什么时候到的、这串字节是什么、这一帧说了什么、为什么不对。
01
字节级双时间戳
每行同时记录会话相对纳秒与墙钟毫秒。跨设备对时序不用猜。
单批带首个字节到达时刻,
tsNs 会话内严格递增02
按帧切分
一次收到三帧拼在一起的块很常见。逐帧切出来再解析,半帧留在缓冲等后续字节。
字面量锚点 + 逐字节扫描 + 校验
03
模板化协议解析
新帧格式只改 JSON 模板,不改代码。内置 Modbus RTU 五个模板,CRC 自动校验。
u8/u16be/bytes/ascii/rest · crc16modbus_le04
AI 看解析后的字段
喂给模型的是「addr=3 功能码 03 数据 01 0B」这样的真实字段,不是乱码方块。
流式输出;无密钥时走离线规则
Protocol
帧才是一句话
同一串字节按模板切出来就是结构化字段:从站地址、功能码、寄存器值、校验结果。
- 切帧与解码分离
- CRC 不过会明确标出来
- 解析结果与原始字节并排
templates/modbus_rtu.json
{
"id": "mb_read_resp",
"dir": "rx",
"pattern": "{addr:u8} 03
{len:u8} {data:bytes:$len}
{crc:crc16modbus_le}"
}
| 传输 | 状态 | 说明 |
|---|---|---|
| Serial / RS232 / RS485 | 已支持 | 波特率、数据位、校验、停止位可配 |
| 远程中继 | 已支持 | 服务端强制只读 |
| Telnet | 规划中 | TCP + IAC 协商 |
| SSH | 规划中 | libssh,需终端渲染视图 |
| Raw TCP / UDP | 规划中 | 自定义设备协议 |
Remote
设备在现场,人在别处
现场端打开串口,生成一次性会话码;远端工程师凭码接入,看到同一份字节流。
现场端 ── 中继 ── 远端
# 现场端 serial /dev/ttyUSB0 @ 115200 session K7M2QX # 30 min # 远端(默认只读) join K7M2QX readonly=true # 现场授权后才可写 grant write
- 只读服务端强制,客户端绕不过
- 授权现场端显式开启才允许写入
- 服务器运行中可切,不重启
- 断线自动重连,配对保留 30 分钟
Download
下载
解压即用,自带 Qt 运行库。
Linux x86-64
v1.0.0 · 28 MB
SHA-256
e72ba8c0fac18ae1df594ba121a02e5377accf115256b89c3903f284a6f0a669
Windows x64
构建中
exe
尚未产出
- 运行时Qt 6.8,LGPL,库随包附带
- 依赖无,解压后 ./probexkit.sh
- 系统Linux x86-64(glibc 2.35+)
- 日志JSONL 每行一条
- 日志路径
~/.local/share/probexkit/ProbeXKit/logs - AI 密钥可选,不配则离线规则
Questions
常见问题
和 PuTTY、minicom 有什么区别?
那些是终端,给你一个能看能打的窗口。ProbeXKit LOG 在意的是字节的结构:
哪几个字节构成一帧、字段是什么、校验过没过。日志可检索、可解析、可导出。
需要联网吗?
不需要。串口收发、切帧、解析、落盘全部本地完成。
只有你点「分析」时,才把选中的那段日志发给模型服务;不点就完全不发。
没有 AI 密钥还能用吗?
能。没配密钥时诊断自动降级为离线规则,串口收发与解析完全不受影响。
自定义协议怎么接?
写一个 JSON 模板放进
templates/ 目录即可,启动时自动加载。
变长字段用 $字段名 引用长度。不用改代码。
远程调试安全吗?
需要一次性会话码,只读限制做在服务端转发层,客户端改 UI 绕不过去。
写入必须现场显式授权。
能同时连多个设备吗?
当前版本一次一个会话。多会话(串口 + SSH + Telnet 并存)正在做架构改造。