Compare commits
17
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 hulk
|
e5b2e45f57 | ||
|
hulk
|
296e220f20 | ||
|
hulk
|
e3ef359df4 | ||
|
hulk
|
be32efa806 | ||
|
hulk
|
8fde79c071 | ||
|
hulk
|
b4328b8be6 | ||
|
hulk
|
4149d203b0 | ||
|
hulk
|
264a0c74a6 | ||
|
hulk
|
190cf29aa5 | ||
|
hulk
|
d658fd459a | ||
|
hulk
|
b627f79dad | ||
|
hulk
|
c26d2cdbaa | ||
|
hulk
|
372cb6b7a0 | ||
|
hulk
|
68fb81fb13 | ||
|
hulk
|
733847a58c | ||
|
hulk
|
f594f60fdd | ||
|
hulk
|
e92fa9f349 |
@@ -10,9 +10,17 @@ dist/
|
||||
# 发布 zip: 可由 src/package_release.py 重新生成, 只上传 Gitea Release
|
||||
DLPilot/release/*.zip
|
||||
EDID-viewer/release/*.zip
|
||||
SerialMate/release/*.zip
|
||||
|
||||
# 源码模式运行时的配置写入(config.BASE_DIR=src/), 与 release/ 下入库的预置栏位区分
|
||||
DLPilot/src/pattern_slots.json
|
||||
# SerialMate 无预置栏位, 运行态配置(最近串口/通道等)一律不入库
|
||||
SerialMate/src/serial_mate.json
|
||||
SerialMate/**/serial_assistant.json
|
||||
SerialMate/release/serial_mate.json
|
||||
# 板型档案(board_profiles.json)是用户本机数据, 首次运行自动生成默认值
|
||||
SerialMate/src/board_profiles.json
|
||||
SerialMate/release/board_profiles.json
|
||||
|
||||
# ZCode 客户端本地会话数据(计划留档等), 非项目配置
|
||||
.zcode/
|
||||
|
||||
@@ -0,0 +1,3 @@
|
||||
[submodule "gd32e230f8_firmware_merge_tool"]
|
||||
path = gd32e230f8_firmware_merge_tool
|
||||
url = https://gitea.hulk.wang/hulk/gd32e230f8_firmware_merge_tool.git
|
||||
+94
-16
@@ -1,14 +1,14 @@
|
||||
# AGENTS.md — DLPilot 工程档案（供 AI/Agent 使用）
|
||||
# AGENTS.md — DLPilot 工程档案（开发约束与进度）
|
||||
|
||||
> **本文档面向 AI/Agent**，是人类文档 [README.md](README.md) 的姊妹篇，两者不重叠：
|
||||
> README 回答"这是什么、怎么用"；本文回答"代码怎么组织、怎么构建发布、改动时哪些约束不能破坏"。
|
||||
> 任何 Agent 在修改本目录代码前应先读完本文。
|
||||
> 人类文档 [README.md](README.md) 回答"这是什么、怎么用"；本文记录"代码怎么组织、
|
||||
> 怎么构建发布、改动时哪些约束不能破坏"，兼作本工具的进度记录。
|
||||
> 修改本目录代码前先读完本文。仓库整体的开发需求与进度管理见根目录 `agent.md`。
|
||||
|
||||
## 1. 项目定位
|
||||
|
||||
仓库 `LT8619C_Debug_Tools` 是 LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板的**调试上位机工具集**，
|
||||
仓库 `HW-Debug-Tools` 是 LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板的**调试上位机工具集**，
|
||||
上游主仓库（固件）为 `hulk/LT8619C_DLPC3421_HDMI`（同 Gitea 实例 `gitea.hulk.wang`），
|
||||
上游固件本机路径 `E:\Hulk-Coding\LT8619C_DLPC3421_HDMI`；工具仓库路径 `E:\Hulk-Coding\LT8619C_Debug_Tools`。
|
||||
上游固件本机路径 `E:\Hulk-Coding\LT8619C_DLPC3421_HDMI`；工具仓库路径 `E:\Hulk-Coding\HW-Debug-Tools`。
|
||||
DLPilot 工作在两端：HDMI **源端**（PC 显卡侧，EDID/分辨率/图案）与**光机控制端**
|
||||
（RS485 → 板载 GD32E230 网关 → DLPC3421）。寄存器语义判读基线（0x606E 位交换 /
|
||||
0x606D 整组顺序）与光机协议规程都在上游仓库 `doc/architecture/` 与 `protocols.md`，不在本仓库。
|
||||
@@ -42,6 +42,8 @@ DLPilot/
|
||||
| `src/config.py` | 运行目录定位(BASE_DIR)与 pattern_slots.json 读写(slots/area/serial 三键) |
|
||||
| `src/dlpc_rs485.py` | 光机 RS485 协议模块: 帧构造/增量解析/译码表/预设命令/串口线程(DLPC485) |
|
||||
| `src/selftest_rs485.py` | 光机协议自检(对照上游实测帧向量, 无硬件回归, 改协议代码后必跑) |
|
||||
| `src/selftest_theme.py` | 主题切换回归(离屏, swatch 底色/渲染像素/标题字号, 改样式后必跑) |
|
||||
| `src/selftest_log.py` | 收发日志上限与队列消费回归(离屏, 改 _dlpc_log/_poll_dlpc 后必跑) |
|
||||
| `src/build_exe.py` | PyInstaller 打包 → `release/DLPilot.exe`（onefile/noconsole, 内嵌图标+pyserial+PySide6-Fluent-Widgets） |
|
||||
| `src/package_release.py` | 复制图案到 release/(平铺) → `release/DLPilot-v<ver>-win64.zip`（校验栏位引用完整性; release/ 与 zip 内容一致） |
|
||||
| `src/publish_gitea.py` | 建/复用 Gitea Release 并上传 zip（tag 默认取 zip 文件名） |
|
||||
@@ -92,6 +94,13 @@ DLPilot/
|
||||
五卡（显示器/模式/EDID 信息/测试图案/hex），右列光机五卡（串口/数据/电源/命令/滑条），
|
||||
支持的模式和 EDID 信息默认折叠；顶栏 Dark/Light/System 切换。Light/Dark 同时更新
|
||||
Fluent 主题、Qt 调色板、容器样式与 Windows DWM 标题栏，勿只调用 setTheme。
|
||||
**fluent 控件的自定义样式禁止直接 setStyleSheet**：setTheme 会用库自带 qss 重刷全部
|
||||
已注册控件，直写样式随之丢失（v0.4.0 swatch 丢底色的根因）。须走
|
||||
`setCustomStyleSheet(控件, lightQss, darkQss)`（qss 需覆盖 hover/pressed/disabled 态，
|
||||
否则悬停瞬间被自带态样式盖回）；仅 PushButton 等无 themeChanged 钩子的控件可幸存。
|
||||
FluentLabelBase 系（StrongBodyLabel 等）例外：其 setTextColor 在每次切主题时整体重写
|
||||
自定义槽，任何 setCustomStyleSheet 都会被冲掉——字号等改用 QFont（自带 label.qss 无
|
||||
font-size 规则，QFont 不会被冲）。RGB swatch 底色回归测试见 selftest_theme.py。
|
||||
PD 协议成功显示绿色，FPDO 仍独立判定。打包必须收集 `qfluentwidgets` 资源，并加入 Windows 系统 `icuuc.dll`，否则 QtCore 可能被其它 ICU DLL 解析失败。
|
||||
|
||||
## 4. 领域语义（测试值都有含义，勿"顺手改"）
|
||||
@@ -155,6 +164,9 @@ python publish_gitea.py ../release/DLPilot-v<版本>-win64.zip --replace --insec
|
||||
- GUI 与 hdmi_source.ps1 各自独立实现显示器枚举，行为可能微差（GUI 与 `-List` 序号一致，
|
||||
但与"设置"面板序号无保证）；多屏操作前先确认序号；
|
||||
- `pattern_slots.json` 兼容两种历史格式，写出只写新格式（详见 §3.11）；
|
||||
- `--seconds` 冒烟在已有 DLPilot 实例（含用户开着的 exe）运行时会"挂起"：run_gui
|
||||
检测到单实例互斥后弹模态框等点击。无头验证改用直启 `App(5)` 的等效脚本，或先关实例；
|
||||
重打包同理——build_exe.py 会 taskkill 同名进程，等于替用户关掉开着的实例；
|
||||
- 旧版 `app_gui.py` 仅保留作历史对照，当前入口使用 `app_fluent.py`；新增或修改界面时
|
||||
应遵循 PySide6-Fluent-Widgets 的控件和 Qt 布局，不要把旧版 CustomTkinter 依赖带回入口。
|
||||
|
||||
@@ -162,18 +174,84 @@ python publish_gitea.py ../release/DLPilot-v<版本>-win64.zip --replace --insec
|
||||
|
||||
1. `python -m compileall -q src`（在 DLPilot/ 下） —— 全模块可编译；
|
||||
2. `python selftest_rs485.py` —— 光机协议回归（改 dlpc_rs485.py 后必跑，向量来自上游 protocols.md）；
|
||||
3. `python hdmi_gui.py --seconds 5` —— GUI 冒烟（自动开关）；
|
||||
4. `python hdmi_gui.py --test-pattern Checker --area 800x600 --seconds 3` —— 投图链路；
|
||||
5. `python hdmi_gui.py --dump` —— EDID 解算不抛异常；
|
||||
6. `python hdmi_gui.py --dlpc-cmd M999`（不带 --port）—— 应明确报错而非崩溃（无硬件时的优雅降级）；
|
||||
7. `python build_exe.py` → 双击 release/DLPilot.exe 确认图标/双栏布局/投图/光机区渲染；
|
||||
8. `python package_release.py <版本>` —— 不报"引用图片缺失"即栏位完整性 OK。
|
||||
3. `python selftest_theme.py` —— 主题切换回归（改 app_fluent.py 涉及样式/主题后必跑；
|
||||
离屏渲染，Dark/Light 往返后校验 swatch 底色样式与渲染像素、标题字号）；
|
||||
3b. `python selftest_log.py` —— 收发日志上限/队列消费回归（改 `_dlpc_log`/`_poll_dlpc`
|
||||
后必跑；600 行封顶 500、坏条目不中断 drain）；
|
||||
4. `python hdmi_gui.py --seconds 5` —— GUI 冒烟（自动开关）；
|
||||
5. `python hdmi_gui.py --test-pattern Checker --area 800x600 --seconds 3` —— 投图链路；
|
||||
6. `python hdmi_gui.py --dump` —— EDID 解算不抛异常；
|
||||
7. `python hdmi_gui.py --dlpc-cmd M999`（不带 --port）—— 应明确报错而非崩溃（无硬件时的优雅降级）；
|
||||
8. `python build_exe.py` → 双击 release/DLPilot.exe 确认图标/双栏布局/投图/光机区渲染；
|
||||
9. `python package_release.py <版本>` —— 不报"引用图片缺失"即栏位完整性 OK。
|
||||
|
||||
## 8. v0.4.0 交接（2026-09-24）
|
||||
## 8. v0.4.0 进度记录（2026-09-24）
|
||||
|
||||
- 入口已切换 `app_fluent.py`；历史 `app_gui.py` 保留，不改其历史版本号。
|
||||
- 本次验证：源码编译通过、RS485 自测 ALL PASS、Qt 离屏浅色渲染、正式 EXE 定时退出码 0。
|
||||
原生桌面自动化不可用，未完成成品 Light 截图；未将硬件功能标记为本次实机验证通过。
|
||||
- 发布须将本次源码、文档、EXE 纳入同一个提交，确认远端标签指向该提交；zip 不入库。
|
||||
- `release/pattern_slots.json` 的本机串口记忆改动、外部 `EDID-viewer/` 不属于本次 UI 提交。
|
||||
发布使用仓库预置配置，临时打包后恢复本机文件，勿将运行态配置悄悄提交。
|
||||
- 发布已将本次源码、文档、EXE 纳入同一个提交（`74b64dc`），远端标签 `DLPilot-v0.4.0`
|
||||
指向该提交、附件已核对；zip 不入库。
|
||||
- `release/pattern_slots.json` 的本机串口记忆改动属于运行态配置，勿随提交悄悄带入；
|
||||
发布使用仓库预置配置，临时打包后恢复本机文件。
|
||||
- 关联动态：EDID-Viewer 已于 2026-09-25 从本工具的"源端 EDID 查看"需求独立成工具
|
||||
入库并发布 v0.1.0，与本目录无代码共享；I2C-Inject 已标记暂停开发（详见根 `agent.md`）。
|
||||
|
||||
## 9. v0.4.0 后修复记录
|
||||
|
||||
- 2026-09-28 修复"切换 Light 后 R/G/B hex 按钮底色丢失、切回 Dark 也不恢复"：根因是
|
||||
fluent 控件直接 `setStyleSheet` 的自定义样式在 `setTheme` 时被库重刷的自带 qss 整体
|
||||
覆盖（任何方向的切换都会丢，非 Light 特有）。swatch 改走 `setCustomStyleSheet`（qss
|
||||
覆盖 hover/pressed/disabled 态），同病的顶栏标题 24px 字号改用 QFont（FluentLabelBase
|
||||
的自定义槽被库的 setTextColor 每次切主题重写，见 §3.12）。新增 `src/selftest_theme.py`
|
||||
离屏回归（样式表存活 + 渲染像素比对），本次验证：compileall / selftest_rs485 /
|
||||
selftest_theme / GUI 冒烟全部通过。
|
||||
- 2026-09-28 以 v0.4.1 重新打包：APP_VERSION → 0.4.1，`build_exe.py` 生成新
|
||||
release/DLPilot.exe（67.1 MB，exe `--seconds 5` 定时退出冒烟 exit 0），按 §8 约定
|
||||
临时还原预置 pattern_slots.json 后 `package_release.py 0.4.1` 生成
|
||||
`DLPilot-v0.4.1-win64.zip`（66.8 MB，zip 内为预置 COM15 配置，本机 COM5 运行态
|
||||
已还原未入库）。Gitea Release 已发布：tag `DLPilot-v0.4.1` 指向提交 `62b325c`
|
||||
（源码+exe+文档同一提交），资产 `DLPilot-v0.4.1-win64.zip`（66.8 MB），
|
||||
https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases/tag/DLPilot-v0.4.1 。
|
||||
发布说明用 --notes-file 传入（内置 DEFAULT_NOTES 模板还是 v0.1.0 旧内容，下次
|
||||
发布记得先写说明文件）。
|
||||
- 2026-09-28 第二修："串口未选/选错点连接后窗口被拉长、刷新按钮够不到"。根因：
|
||||
pyserial 原始异常串（`could not open port '': FileNotFoundError...`）整段塞进
|
||||
状态 BodyLabel，QLabel 不换行时最小宽度=整行文本宽，把右列参数行最小宽度撑爆。
|
||||
三层修复：①`_dlpc_toggle` 空串口直接短提示返回（不再先写 SERIAL_CFG/save_slots
|
||||
再 open——旧代码这顺序还会把本机串口记忆覆写成空串，本机 COM5 记忆即这样丢失过，
|
||||
已手工修回）；②dlpc_rs485 open 失败消息分类为短提示（被占用/不存在/其它），
|
||||
完整异常改走 on_event 进收发日志；③`lbl_dlpc_st.setWordWrap(True)` 兜底。
|
||||
验证：compileall / selftest_rs485 ALL PASS / 离屏断言（空串口提示、长文本下标签
|
||||
最小宽度<300 可换行）/ GUI 冒烟 / 新 exe `--seconds 5` exit 0；v0.4.1 exe（15:05）
|
||||
与 zip 均已用该修复重打。
|
||||
- 2026-09-28 v0.4.2 两处 UI 小修：①"串口数据 · 收发日志"卡的"清空"按钮原本自占
|
||||
一行（_card 的标题行是独立 row，按钮行加在其下），与标题错位且多占一行高度——
|
||||
`_card()` 增加 `trailing` 参数把按钮并入标题行右端；②v0.4.0 fluent 重写把旧版
|
||||
app_gui.py 光机命令卡首行的快捷按钮排（开光机/关光机/查版本/软件重启/开TEC/
|
||||
关TEC/TEC33.0°C）整行丢失，开/关光机只能走预设下拉——本次按旧版排布原样恢复，
|
||||
位于电流行与预设行之间（命令直发 `_dlpc_send`，无新增协议逻辑）。
|
||||
验证：compileall / selftest_rs485 / selftest_theme ALL PASS；离屏渲染断言"清空"
|
||||
与标题垂直中心差 0px、7 个快捷按钮齐全；真实桌面冒烟 exit 0。APP_VERSION → 0.4.2
|
||||
并重打包。v0.4.2 已发布：tag `DLPilot-v0.4.2` 指向提交 `7bd9943`（源码+exe+文档
|
||||
同一提交），资产 `DLPilot-v0.4.2-win64.zip`（66.8 MB，zip 内为预置 COM15 配置，
|
||||
本机 COM5 运行态已还原未入库），
|
||||
https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases/tag/DLPilot-v0.4.2 。
|
||||
本次发布说明已用 --notes-file 传入（临时文件，未入库）。
|
||||
- 2026-10-13 v0.4.3 修复"长会话越跑越卡、命令点了没反应"（FilmForge 同案）：
|
||||
根因是 `_dlpc_log` 的手工 textCursor 裁剪用了**实例级枚举访问**
|
||||
（`cursor.Start`/`cursor.BlockUnderCursor`），PySide6 6.11 移除该形式，收发日志
|
||||
超 500 行后每次追加必抛 AttributeError；异常又逃出 `_poll_dlpc` 的 drain 循环
|
||||
（旧 try 只捕获 queue.Empty），每 tick 最多消费到第一条 event，`_dlpc_log_q`
|
||||
棘轮积压、日志裁剪/自动滚动全失效；电源自检/功率检测序列在 `_pd_step_next()`
|
||||
之前的 `_dlpc_log` 调用处被打断，`_pd_seq` 永不清空，后续所有手动命令被
|
||||
"序列进行中"拦截直到断开重连。整改：①改用 `setMaximumBlockCount(500)` 环形
|
||||
裁剪（O(1)，不依赖枚举写法）；②`_poll_dlpc` 改逐事件兜底 try/except，单条异常
|
||||
只打栈放弃该条、不再中断本轮消费；③新增 `selftest_log.py` 回归（600 行封顶 +
|
||||
坏条目 drain 不中断）。验证：compileall / selftest_rs485 / selftest_theme /
|
||||
selftest_log ALL PASS；GUI 冒烟 exit 0；`--dump` / `--dlpc-cmd`（无串口）正常。
|
||||
APP_VERSION → 0.4.3 重打包（67.1 MB），按 §8 约定临时还原预置 pattern_slots.json
|
||||
后 `package_release.py 0.4.3` 生成 `DLPilot-v0.4.3-win64.zip`（66.8 MB，zip 内
|
||||
为预置 COM15 配置，本机 COM5 运行态已还原未入库）。遗留（未随本版处理）：
|
||||
`dlpc_rs485.py` 的 `except OSError` 把写超时（SerialTimeoutException）与设备
|
||||
拔出混判，一次转换器停滞即断链误报"设备拔出"。
|
||||
|
||||
+2
-2
@@ -4,7 +4,7 @@
|
||||
> HDMI **源端**（EDID 查看、分辨率切换、纯色/测试图案投屏）+ **光机控制**
|
||||
> （RS485 直连板上 GD32 网关，开关光机/设光强/查温度电流）。
|
||||
>
|
||||
> - **只想用工具**：到 [Gitea Releases](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases)
|
||||
> - **只想用工具**：到 [Gitea Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases)
|
||||
> 下载 `DLPilot-vX.Y.Z-win64.zip`，解压双击 `DLPilot.exe` 即可（Windows 10/11 x64，免安装、无需 Python）。
|
||||
> - **要改代码/重新打包**：见 §8、§9。
|
||||
>
|
||||
@@ -28,7 +28,7 @@
|
||||
|
||||
## 2. 下载与安装
|
||||
|
||||
1. 打开 [Releases 页面](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases)，取最新的
|
||||
1. 打开 [Releases 页面](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases)，取最新的
|
||||
`DLPilot-vX.Y.Z-win64.zip`；
|
||||
2. 解压到**任意可写目录**（自定义图片与栏位配置会写到 exe 旁边）；
|
||||
3. 双击 `DLPilot.exe`。首次启动比脚本慢一两秒（onefile 解压），属正常现象。
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
> HDMI **源端**（EDID 查看、分辨率切换、纯色/测试图案投屏）+ **光机控制**
|
||||
> （RS485 直连板上 GD32 网关，开关光机/设光强/查温度电流）。
|
||||
>
|
||||
> - **只想用工具**：到 [Gitea Releases](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases)
|
||||
> - **只想用工具**：到 [Gitea Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases)
|
||||
> 下载 `DLPilot-vX.Y.Z-win64.zip`，解压双击 `DLPilot.exe` 即可（Windows 10/11 x64，免安装、无需 Python）。
|
||||
> - **要改代码/重新打包**：见 §8、§9。
|
||||
>
|
||||
@@ -28,7 +28,7 @@
|
||||
|
||||
## 2. 下载与安装
|
||||
|
||||
1. 打开 [Releases 页面](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases)，取最新的
|
||||
1. 打开 [Releases 页面](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases)，取最新的
|
||||
`DLPilot-vX.Y.Z-win64.zip`；
|
||||
2. 解压到**任意可写目录**（自定义图片与栏位配置会写到 exe 旁边）；
|
||||
3. 双击 `DLPilot.exe`。首次启动比脚本慢一两秒（onefile 解压），属正常现象。
|
||||
|
||||
+48
-16
@@ -13,6 +13,7 @@ import queue
|
||||
import re
|
||||
import sys
|
||||
import time
|
||||
import traceback
|
||||
|
||||
# PyInstaller keeps Shiboken's ABI DLLs in a sibling directory. Register both
|
||||
# Qt and Shiboken before importing QtCore; this is required by one-file builds
|
||||
@@ -52,7 +53,8 @@ from PySide6.QtWidgets import (
|
||||
)
|
||||
from qfluentwidgets import (
|
||||
BodyLabel, CardWidget, ComboBox, LineEdit, PlainTextEdit,
|
||||
PrimaryPushButton, PushButton, Slider, StrongBodyLabel, Theme, setTheme,
|
||||
PrimaryPushButton, PushButton, Slider, StrongBodyLabel, Theme,
|
||||
setCustomStyleSheet, setTheme,
|
||||
)
|
||||
|
||||
import config
|
||||
@@ -62,8 +64,8 @@ import edid_parse
|
||||
import patterns
|
||||
|
||||
APP_NAME = "DLPilot"
|
||||
APP_VERSION = "0.4.0"
|
||||
REPO_URL = "https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools"
|
||||
APP_VERSION = "0.4.3"
|
||||
REPO_URL = "https://gitea.hulk.wang/hulk/HW-Debug-Tools"
|
||||
MONO = QFont("Consolas", 10)
|
||||
CHIP_IDLE = "#666666"
|
||||
CHIP_OK = "#2FA574"
|
||||
@@ -209,7 +211,7 @@ class App(QMainWindow):
|
||||
button.clicked.connect(callback)
|
||||
return button
|
||||
|
||||
def _card(self, title, parent):
|
||||
def _card(self, title, parent, trailing=None):
|
||||
card = CardWidget(parent)
|
||||
layout = QVBoxLayout(card)
|
||||
layout.setContentsMargins(14, 12, 14, 14)
|
||||
@@ -217,6 +219,8 @@ class App(QMainWindow):
|
||||
row = QHBoxLayout()
|
||||
row.addWidget(StrongBodyLabel(title, card))
|
||||
row.addStretch(1)
|
||||
if trailing is not None:
|
||||
row.addWidget(trailing)
|
||||
layout.addLayout(row)
|
||||
return card, layout
|
||||
|
||||
@@ -266,7 +270,12 @@ class App(QMainWindow):
|
||||
outer.setSpacing(12)
|
||||
header = QHBoxLayout()
|
||||
title = StrongBodyLabel("DLPilot", root)
|
||||
title.setStyleSheet("font-size: 24px; font-weight: 700;")
|
||||
# 标题字号走 QFont：FluentLabelBase 在每次主题切换时会用自带的颜色规则
|
||||
# 重写自定义 qss 槽，setStyleSheet/setCustomStyleSheet 写的字号都会被冲掉
|
||||
title_font = title.font()
|
||||
title_font.setPixelSize(24)
|
||||
title_font.setBold(True)
|
||||
title.setFont(title_font)
|
||||
header.addWidget(title)
|
||||
header.addWidget(BodyLabel("EDID · 测试图案 · RS485 光机控制", root))
|
||||
header.addStretch(1)
|
||||
@@ -355,7 +364,13 @@ class App(QMainWindow):
|
||||
row.addWidget(BodyLabel(f"{channel}: 0x", card))
|
||||
for label, color in items:
|
||||
button = PushButton(label, card)
|
||||
button.setStyleSheet(f"PushButton {{ background: {color}; color: {'black' if color == '#00FF00' else 'white'}; }}")
|
||||
# fluent 控件的样式须走 setCustomStyleSheet：直接 setStyleSheet 的内容
|
||||
# 会在 setTheme 时被库重刷的自带 qss 冲掉；且须覆盖 hover/pressed 态，
|
||||
# 否则悬停瞬间底色仍会被自带态样式盖回
|
||||
fg = 'black' if color == '#00FF00' else 'white'
|
||||
qss = ("PushButton, PushButton:hover, PushButton:pressed, "
|
||||
f"PushButton:disabled {{ background-color: {color}; color: {fg}; border: none; }}")
|
||||
setCustomStyleSheet(button, qss, qss)
|
||||
button.clicked.connect(lambda checked=False, c=color: self._show_solid(c))
|
||||
row.addWidget(button)
|
||||
row.addStretch(1)
|
||||
@@ -414,18 +429,22 @@ class App(QMainWindow):
|
||||
setattr(self, attr, combo)
|
||||
params.addWidget(combo)
|
||||
self.lbl_dlpc_st = BodyLabel("未连接", card)
|
||||
# 状态标签允许换行兜底: 任何长错误串都不得撑大参数行最小宽度(否则窗口拉长,
|
||||
# 刷新/连接按钮被挤出可视区)
|
||||
self.lbl_dlpc_st.setWordWrap(True)
|
||||
params.addWidget(self.lbl_dlpc_st)
|
||||
params.addStretch(1)
|
||||
body.addLayout(params)
|
||||
layout.addWidget(card)
|
||||
|
||||
card, body = self._card("串口数据 · 收发日志（译码 + 原始 hex）", self)
|
||||
row = QHBoxLayout()
|
||||
row.addStretch(1)
|
||||
row.addWidget(self._button("清空", self._dlpc_clear))
|
||||
body.addLayout(row)
|
||||
card, body = self._card("串口数据 · 收发日志（译码 + 原始 hex）", self,
|
||||
trailing=self._button("清空", self._dlpc_clear))
|
||||
self.txt_dlpc = self._text()
|
||||
self.txt_dlpc.setMinimumHeight(230)
|
||||
# 收发日志环形裁剪: 超 500 行自动丢最旧(O(1))。勿改回 textCursor 手工裁剪——
|
||||
# PySide6 6.11 移除实例级枚举访问, cursor.Start 必抛 AttributeError 且异常会
|
||||
# 打断 _poll_dlpc 的队列消费(事件棘轮积压), 回归见 selftest_log.py
|
||||
self.txt_dlpc.document().setMaximumBlockCount(500)
|
||||
body.addWidget(self.txt_dlpc)
|
||||
self._dlpc_log("帧格式: D5 01 LEN <命令> CRC / B5 TYPE LEN <payload> CRC")
|
||||
layout.addWidget(card)
|
||||
@@ -457,6 +476,14 @@ class App(QMainWindow):
|
||||
row.addStretch(1)
|
||||
row.addWidget(self._button("查电流", self._query_current))
|
||||
body.addLayout(row)
|
||||
# 快捷命令行: v0.4.0 重写时从旧版 app_gui.py 丢失, 开关光机等一发命令
|
||||
# 不应只能走预设下拉
|
||||
quick = QHBoxLayout()
|
||||
for name, cmd in (("开光机", "M730S0"), ("关光机", "M730S1"), ("查版本", "M999"),
|
||||
("软件重启", "M888"), ("开TEC", "M7S0"), ("关TEC", "M7S1"),
|
||||
("TEC33.0°C", "M8S330")):
|
||||
quick.addWidget(self._button(name, lambda checked=False, c=cmd: self._dlpc_send(c)))
|
||||
body.addLayout(quick)
|
||||
preset_row = QHBoxLayout()
|
||||
self._dlpc_presets = [(n, cmd) for n, cmd, _ in dlpc_rs485.PRESETS]
|
||||
self.cbo_dlpc_cmd = ComboBox(card)
|
||||
@@ -733,9 +760,12 @@ class App(QMainWindow):
|
||||
def _query_lamp(self): self._tl_order.append('LAMP'); self._dlpc_send('M202')
|
||||
|
||||
def _poll_dlpc(self):
|
||||
try:
|
||||
while True:
|
||||
while True:
|
||||
try:
|
||||
kind, value = self._dlpc_log_q.get_nowait()
|
||||
except queue.Empty:
|
||||
break
|
||||
try:
|
||||
if kind == 'status':
|
||||
self.lbl_dlpc_st.setText(value)
|
||||
if value.startswith(('已断开', '串口丢失')): self._serial_reset_state()
|
||||
@@ -744,15 +774,16 @@ class App(QMainWindow):
|
||||
elif kind == 'pdframe': self._pd_step_done(value.type_code == 0xF0, value)
|
||||
elif kind == 'pwrframe': self._pwr_step_done(value)
|
||||
else: self._dlpc_log(value)
|
||||
except queue.Empty: pass
|
||||
except Exception:
|
||||
# 单条事件处理异常只打栈放弃该条, 不得中断本轮消费——否则积压随事件流
|
||||
# 单调增长(v0.4.3 前日志裁剪异常即此路径, 显示延迟越跑越大)
|
||||
traceback.print_exc()
|
||||
connected = self.dlpc.is_connected()
|
||||
if connected != self._dlpc_connected:
|
||||
self._dlpc_connected = connected; self.btn_dlpc.setText("断开" if connected else "连接")
|
||||
|
||||
def _dlpc_log(self, line):
|
||||
self.txt_dlpc.appendPlainText(time.strftime('%H:%M:%S ') + line)
|
||||
if self.txt_dlpc.blockCount() > 500:
|
||||
cursor = self.txt_dlpc.textCursor(); cursor.movePosition(cursor.Start); cursor.select(cursor.BlockUnderCursor); cursor.removeSelectedText(); cursor.deleteChar()
|
||||
self.txt_dlpc.verticalScrollBar().setValue(self.txt_dlpc.verticalScrollBar().maximum())
|
||||
|
||||
def _dlpc_clear(self): self.txt_dlpc.clear()
|
||||
@@ -770,6 +801,7 @@ class App(QMainWindow):
|
||||
def _dlpc_toggle(self):
|
||||
if self.dlpc.is_connected(): self.dlpc.close(); self._serial_reset_state(); return
|
||||
port = self._dlpc_selected_port()
|
||||
if not port: self.lbl_dlpc_st.setText('未选择串口，请先选择或刷新'); return
|
||||
try: baud, bytesize, stopbits = int(self.cbo_baud.currentText()), int(self.cbo_databits.currentText()), int(self.cbo_stopbits.currentText())
|
||||
except ValueError: self.lbl_dlpc_st.setText("串口参数非法"); return
|
||||
parity = self.cbo_parity.currentText()[:1] or 'N'; config.SERIAL_CFG.update(port=port, baud=baud, bytesize=bytesize, parity=parity, stopbits=stopbits); config.save_slots(self.slots, self.cbo_area.currentText()); self.dlpc.open(port, baud, bytesize=bytesize, parity=parity, stopbits=stopbits)
|
||||
|
||||
@@ -41,7 +41,7 @@ CHIP_ERR = '#D9534F'
|
||||
|
||||
APP_NAME = 'DLPilot'
|
||||
APP_VERSION = '0.3.6'
|
||||
REPO_URL = 'https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools'
|
||||
REPO_URL = 'https://gitea.hulk.wang/hulk/HW-Debug-Tools'
|
||||
|
||||
|
||||
def get_icon_path():
|
||||
|
||||
@@ -326,11 +326,19 @@ class DLPC485:
|
||||
self.ser = None
|
||||
with self._lock:
|
||||
self._target = None
|
||||
et = str(e)
|
||||
if 'PermissionError' in repr(e) or '拒绝访问' in et \
|
||||
or 'Access is denied' in et:
|
||||
et += '（串口被占用: 检查串口助手/另一个本工具实例）'
|
||||
self.on_status(f'连接失败: {et}')
|
||||
blob = str(e) + repr(e)
|
||||
if 'PermissionError' in blob or '拒绝访问' in blob \
|
||||
or 'Access is denied' in blob:
|
||||
hint = '串口被占用（串口助手/另一实例?）'
|
||||
elif 'FileNotFoundError' in blob or '找不到指定的' in blob \
|
||||
or 'No such file' in blob:
|
||||
hint = '串口不存在，请刷新后重选'
|
||||
else:
|
||||
hint = '无法打开，详情见日志'
|
||||
# 状态标签只放短提示(长异常串会撑爆参数行把窗口拉长),
|
||||
# 完整异常走 on_event 进收发日志
|
||||
self.on_status(f'连接失败: {hint}')
|
||||
self.on_event(f'连接失败: {e!r}')
|
||||
if self.ser is not None:
|
||||
try:
|
||||
item = None
|
||||
|
||||
@@ -0,0 +1,70 @@
|
||||
# coding: utf-8
|
||||
"""收发日志上限与队列消费回归自检（无窗口, 离屏渲染）。
|
||||
|
||||
背景: v0.4.3 之前收发日志用 textCursor 手工裁剪, 其中 `cursor.Start` /
|
||||
`cursor.BlockUnderCursor` 是实例级枚举访问 —— PySide6 6.11 移除了该形式,
|
||||
日志一旦超过 500 行, 每次 _dlpc_log 追加后必抛 AttributeError; 且异常会
|
||||
逃出 _poll_dlpc 的 drain 循环（旧 try 只捕获 queue.Empty）, 每 tick 最多
|
||||
消费到第一条 event, `_dlpc_log_q` 棘轮积压、日志裁剪与自动滚动全部失效,
|
||||
电源自检/功率检测序列还会被异常打断在启动处（之后所有命令被"序列进行中"
|
||||
拦截）。v0.4.3 改为 setMaximumBlockCount 环形裁剪 + 逐事件异常兜底。
|
||||
|
||||
本测试保证:
|
||||
1. 连续追加 600 行日志不抛异常, document().blockCount() 环形封顶 500, 末行在;
|
||||
2. 单条异常事件（模拟未来引入的坏数据）不中断 _poll_dlpc 本轮队列消费
|
||||
—— 其后的事件仍全部入日志、队列清空。
|
||||
|
||||
运行: python selftest_log.py （依赖 PySide6-Fluent-Widgets 与 pyserial ——
|
||||
串口卡构建后 txt_dlpc 才存在）
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
|
||||
os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
|
||||
from PySide6.QtWidgets import QApplication
|
||||
from qfluentwidgets import Theme, setTheme
|
||||
|
||||
import app_fluent
|
||||
import dlpc_rs485
|
||||
|
||||
|
||||
def check_cap(win):
|
||||
for i in range(600):
|
||||
win._dlpc_log(f"cap-line-{i}")
|
||||
blocks = win.txt_dlpc.document().blockCount()
|
||||
has_last = "cap-line-599" in win.txt_dlpc.toPlainText()
|
||||
print(f" 追加 600 行: blockCount={blocks}(封顶 500), 末行在: {has_last}")
|
||||
return blocks <= 500 and has_last
|
||||
|
||||
|
||||
def check_drain_resilience(win):
|
||||
win._timer.stop() # 排除 80ms 轮询定时器干扰
|
||||
win._dlpc_log_q.put(("pdframe", "poison-not-a-frame")) # 该条分发必抛异常
|
||||
win._dlpc_log_q.put(("event", "after-poison-1"))
|
||||
win._dlpc_log_q.put(("event", "after-poison-2"))
|
||||
win._poll_dlpc() # 单次手动驱动(不进事件循环)
|
||||
left = win._dlpc_log_q.qsize()
|
||||
text = win.txt_dlpc.toPlainText()
|
||||
drained = left == 0 and "after-poison-1" in text and "after-poison-2" in text
|
||||
print(f" 坏条目后消费不中断: 残留队列={left}, 后续事件全部写入: {drained}")
|
||||
return drained
|
||||
|
||||
|
||||
def main():
|
||||
if not dlpc_rs485.HAS_SERIAL:
|
||||
print("FAILED 缺少 pyserial: 串口卡未构建, txt_dlpc 不存在")
|
||||
return 1
|
||||
app = QApplication.instance() or QApplication(sys.argv)
|
||||
setTheme(Theme.AUTO)
|
||||
win = app_fluent.App(0)
|
||||
passed = check_cap(win)
|
||||
passed &= check_drain_resilience(win)
|
||||
win.close()
|
||||
print("ALL PASS" if passed else "FAILED")
|
||||
return 0 if passed else 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
@@ -0,0 +1,82 @@
|
||||
# coding: utf-8
|
||||
"""主题切换回归自检（无窗口, 离屏渲染）。
|
||||
|
||||
背景: fluent 控件直接 setStyleSheet 的样式会在 setTheme 时被库重刷的自带 qss 冲掉
|
||||
（v0.4.0 RGB swatch 按钮切主题丢底色的根因）。swatch 改走 setCustomStyleSheet、
|
||||
标题字号走 QFont 后，本测试保证:
|
||||
1. Dark -> Light -> Dark -> Light 往返后 9 个 swatch 按钮样式表仍带底色；
|
||||
2. Light 下实际渲染出的按钮中心像素 = swatch 色值（不只样式表字符串存在）；
|
||||
3. 标题 24px 加粗（QFont）在往返后不变。
|
||||
|
||||
运行: python selftest_theme.py （依赖 PySide6-Fluent-Widgets）
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
|
||||
os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
|
||||
from PySide6.QtGui import QColor
|
||||
from PySide6.QtWidgets import QApplication
|
||||
from qfluentwidgets import PushButton, StrongBodyLabel, Theme, setTheme
|
||||
|
||||
import app_fluent
|
||||
import patterns
|
||||
|
||||
|
||||
def check_style_sheet(win, app):
|
||||
swatches = [b for b in win.findChildren(PushButton) if b.text() in {"55", "AA", "FF"}]
|
||||
assert len(swatches) == 9, f"expect 9 swatch buttons, got {len(swatches)}"
|
||||
title = [l for l in win.findChildren(StrongBodyLabel) if l.text() == "DLPilot"]
|
||||
assert len(title) == 1, "title label not found"
|
||||
colored = sum(1 for b in swatches if "background-color: #" in b.styleSheet())
|
||||
f = title[0].font()
|
||||
print(f" swatch 样式表带底色: {colored}/9, 标题 24px 粗体: "
|
||||
f"{f.pixelSize() == 24 and f.bold()}")
|
||||
return colored == 9 and f.pixelSize() == 24 and f.bold()
|
||||
|
||||
|
||||
def check_rendered_pixel(win, app):
|
||||
"""Light 主题下逐个渲染 swatch，与目标色一致的像素须占明显多数（背景为主，
|
||||
中心处是文字字形，不能只采单点）。"""
|
||||
ok = True
|
||||
for channel, items in patterns.SOLID_ROWS:
|
||||
for label, color in items:
|
||||
button = next(b for b in win.findChildren(PushButton)
|
||||
if b.text() == label and f"background-color: {color}" in b.styleSheet())
|
||||
image = button.grab().toImage()
|
||||
target = QColor(color)
|
||||
total, matched = image.width() * image.height(), 0
|
||||
for y in range(image.height()):
|
||||
for x in range(image.width()):
|
||||
if image.pixelColor(x, y) == target:
|
||||
matched += 1
|
||||
ratio = matched / total
|
||||
same = ratio >= 0.2
|
||||
ok &= same
|
||||
if not same:
|
||||
print(f" 渲染不符: {channel}/{label} 期望 {color} 仅占 {ratio:.0%}")
|
||||
print(f" Light 下渲染像素比对: {'一致' if ok else '存在偏差'}")
|
||||
return ok
|
||||
|
||||
|
||||
def main():
|
||||
app = QApplication.instance() or QApplication(sys.argv)
|
||||
setTheme(Theme.AUTO)
|
||||
win = app_fluent.App(0)
|
||||
passed = True
|
||||
for step, theme in (("初始 Dark", Theme.DARK), ("切 Light", Theme.LIGHT),
|
||||
("切回 Dark", Theme.DARK), ("再切 Light", Theme.LIGHT)):
|
||||
setTheme(theme)
|
||||
app.processEvents()
|
||||
print(f"[{step}]")
|
||||
passed &= check_style_sheet(win, app)
|
||||
if theme == Theme.LIGHT:
|
||||
passed &= check_rendered_pixel(win, app)
|
||||
win.close()
|
||||
print("ALL PASS" if passed else "FAILED")
|
||||
return 0 if passed else 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
+11
-2
@@ -1,7 +1,7 @@
|
||||
# EDID Viewer — 环境与任务声明
|
||||
# EDID Viewer — 开发需求与进度
|
||||
|
||||
## 基本环境
|
||||
- 主项目位置：`E:\Hulk-Coding\LT8619C_Debug_Tools\EDID-viewer`；为兼容此前约定，已同步镜像到 `E:\Hulk-Coding\LT8619C\_Debug\_Tools\EDID-viewer`。
|
||||
- 主项目位置：`E:\Hulk-Coding\HW-Debug-Tools\EDID-viewer`；为兼容此前约定，已同步镜像到 `E:\Hulk-Coding\LT8619C\_Debug\_Tools\EDID-viewer`。
|
||||
- Windows 10/11 x64；Python 3.14；PySide6 6.11.2（Qt 官方 Python 绑定）；PySide6-Fluent-Widgets 1.11.3。
|
||||
- 使用项目 `.venv`；依赖见 requirements.txt；GUI 入口为 `src/main.py`（版本号在 `src/main.py` 的 `APP_VERSION`）。
|
||||
- 独立工具，不依赖、不修改 LT8619C 固件或 DLPilot 工程。
|
||||
@@ -38,6 +38,15 @@
|
||||
- 添加解析边界/错误数据测试。打包后验证实际可见窗口、缩放、刷新和导入导出流程。
|
||||
- 第一版不完整解码 DisplayID、HDMI Forum VRR/DSC；保留原始块供分析。
|
||||
|
||||
## 进度记录
|
||||
- **v0.1.0（2026-09-25，已发布）**：目录对齐 DLPilot 三区结构；onefile 打包
|
||||
（`src/build_exe.py` 生成 spec，剔除 PATH 上 Poppler/Conda 的版本化 ICU）；Light
|
||||
主题三件套修复（setTheme + QPalette/应用级 QSS + DWM 标题栏）；右上角"关于"；
|
||||
标签 `EDID-Viewer-v0.1.0` 与 Release 附件已核对（66,483,477 字节）。
|
||||
- 验证明细见 `VALIDATION.md`；实机验收缺口：HDMI 热插拔、多屏、跨屏 DPI、
|
||||
最大化/恢复与导入导出完整交互流程。
|
||||
- 根目录 `agent.md` 为仓库整体的开发需求与进度管理文档。
|
||||
|
||||
## 后续建议
|
||||
- EDID 对比、字节差异与固件数组导出。
|
||||
- HDMI Forum VRR/ALLM/FRL/DSC、DisplayID 与高级色彩数据解析。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Windows 10/11 显示器 EDID 查看器。使用 **PySide6 / PySide6-Fluent-Widgets**，只读，不修改显示设置。
|
||||
|
||||
> 只想使用工具：到 [Gitea Releases](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases)
|
||||
> 只想使用工具：到 [Gitea Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases)
|
||||
> 下载 `EDID-Viewer-vX.Y.Z-win64.zip`，解压双击 `EDID-Viewer.exe` 即可（Windows 10/11 x64，免安装、无需 Python）。
|
||||
|
||||
## 使用
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Windows 10/11 显示器 EDID 查看器。使用 **PySide6 / PySide6-Fluent-Widgets**，只读，不修改显示设置。
|
||||
|
||||
> 只想使用工具：到 [Gitea Releases](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases)
|
||||
> 只想使用工具：到 [Gitea Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases)
|
||||
> 下载 `EDID-Viewer-vX.Y.Z-win64.zip`，解压双击 `EDID-Viewer.exe` 即可（Windows 10/11 x64，免安装、无需 Python）。
|
||||
|
||||
## 使用
|
||||
|
||||
@@ -41,7 +41,7 @@ from windows_edid import scan
|
||||
|
||||
APP_NAME = "EDID Viewer"
|
||||
APP_VERSION = "0.1.0"
|
||||
REPO_URL = "https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools"
|
||||
REPO_URL = "https://gitea.hulk.wang/hulk/HW-Debug-Tools"
|
||||
|
||||
|
||||
def icon_path():
|
||||
|
||||
@@ -1,5 +1,9 @@
|
||||
# I2C-Inject — LT8619C 寄存器择机注入工具
|
||||
|
||||
> **⏸ 状态：暂停开发（2026-09-25）。** 工具与固件保留在仓库中不作删除，当前没有继续开发的计划。
|
||||
> demo 板寄存器语义实测当时即由本工具完成；0x606E 其余位交换经确认（2026-09-25）现状正常、
|
||||
> 符合预期，无需单独实测。恢复开发前请勿视为完整可用。
|
||||
|
||||
> 更新：2026-09-03。由两部分组成：**RP2040 注入器固件**（`mcu-rp2040/`，刷入
|
||||
> BPI-Pico-RP2040，MicroPython）+ **PC 端 GUI**（`i2c_inject_gui.py` / 打包版
|
||||
> `I2C-Inject.exe`）。可在 LT8619C demo 板的 I2C 总线上安全地在线读写寄存器。
|
||||
|
||||
@@ -1,53 +1,79 @@
|
||||
# LT8619C_Debug_Tools
|
||||
# HW-Debug-Tools
|
||||
|
||||
LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板调试配套上位机工具集。
|
||||
硬件调试上位机工具集，起家于 LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板调试配套，
|
||||
现收纳全部调试工具；原名 `LT8619C_Debug_Tools`，2026-09-28 更名（Gitea 旧地址自动重定向）。
|
||||
上游主仓库（固件）：[LT8619C_DLPC3421_HDMI](https://gitea.hulk.wang/hulk/LT8619C_DLPC3421_HDMI)。
|
||||
|
||||
## 工具一览
|
||||
|
||||
| 工具 | 用途 | 获取 |
|
||||
|---|---|---|
|
||||
| [DLPilot](DLPilot/) | HDMI 源端（EDID 查看/逐字节解析、分辨率切换、纯色与测试图案全屏投屏）+ 光机控制（RS485→GD32 网关→DLPC3421：开关光机/设光强/查温度电流） | 到 [Releases](https://gitea.hulk.wang/hulk/LT8619C_Debug_Tools/releases) 下 `DLPilot-vX.Y.Z-win64.zip`，解压即用；详见 [DLPilot/README.md](DLPilot/README.md) |
|
||||
| [I2C-Inject](I2C-Inject/) | LT8619C 寄存器在线读写：RP2040 注入器在 demo 板 I2C 总线上择机注入（避让主控轮询，写后自动读回校验） | 需配合 RP2040 固件 `rp2040_inject.py`；详见 [I2C-Inject/README.md](I2C-Inject/README.md) |
|
||||
| 图标 | 工具 | 用途 | 获取 |
|
||||
|---|---|---|---|
|
||||
| <img src="DLPilot/src/logos/logo_dlpilot.png" width="64" alt="DLPilot 图标"/> | [DLPilot](DLPilot/) | HDMI 源端（EDID 查看/逐字节解析、分辨率切换、纯色与测试图案全屏投屏）+ 光机控制（RS485→GD32 网关→DLPC3421：开关光机/设光强/查温度电流） | 到 [Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases) 下 `DLPilot-vX.Y.Z-win64.zip`，解压即用；详见 [DLPilot/README.md](DLPilot/README.md) |
|
||||
| <img src="EDID-viewer/assets/edid-viewer.png" width="64" alt="EDID-Viewer 图标"/> | [EDID-viewer](EDID-viewer/) | Windows 显示器 EDID 只读查看器：活动设备或离线文件的厂家/序列号/分辨率时序、CTA/HDMI/音频/HDR 能力、校验诊断；BIN/HEX 导入，BIN/JSON 报告导出 | 到 [Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases) 下 `EDID-Viewer-vX.Y.Z-win64.zip`，解压即用；详见 [EDID-viewer/README.md](EDID-viewer/README.md) |
|
||||
| <img src="SerialMate/assets/serial-mate.png" width="64" alt="SerialMate 图标"/> | [SerialMate](SerialMate/) | RS485/串口调试助手：收发 + 协议包解析（帧构成令牌序列/包头/板ID/LEN口径/CRC 全可定制，默认兼容 DLPilot 光机协议）、板型档案一键切换协议参数与命令预设、payload 字符串/HEX 显示、4 通道曲线（弹窗独立、时间窗滑笔回看、悬停读值、暂停渲染）、发送框输入 payload 自动包装组帧（`/` 分隔多条）、HEX 直发与周期发送 | 到 [Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases) 下 `SerialMate-vX.Y.Z-win64.zip`，解压即用；详见 [SerialMate/README.md](SerialMate/README.md) |
|
||||
| <img src="I2C-Inject/logos/logo_i2c_orange.png" width="64" alt="I2C-Inject 图标"/> | [I2C-Inject](I2C-Inject/) | ⏸ **暂停开发**：LT8619C 寄存器在线读写（RP2040 注入器在 demo 板 I2C 总线上择机注入，避让主控轮询，写后自动读回校验）。代码与固件保留备查 | 暂不提供发布；状态与原理详见 [I2C-Inject/README.md](I2C-Inject/README.md) |
|
||||
| <img src="gd32e230f8_firmware_merge_tool/FlashTool/src/logos/logo_flash.png" width="64" alt="GD32 固件工具图标"/> | [gd32e230f8_firmware_merge_tool](gd32e230f8_firmware_merge_tool/) | 🔗 **子模块**（独立仓库独立管理）：GD32E230 固件工具——APP/BL 合成补齐（`_UPDATE.bin`/`_BL.bin`）+ DAPLink Flash GUI 烧录（自带 OpenOCD 工具链） | 本仓目录即快捷入口；版本更新与发布在其[原仓库](https://gitea.hulk.wang/hulk/gd32e230f8_firmware_merge_tool)（Releases 下 zip 解压即用）；详见 [README](gd32e230f8_firmware_merge_tool/README.md) |
|
||||
|
||||
## 环境要求
|
||||
|
||||
- 发布版 zip 开箱即用（Windows 10/11 x64，无需安装 Python）
|
||||
- 源码运行：Python ≥3.10；DLPilot 命令行/EDID 纯标准库，GUI 需
|
||||
`py -m pip install PySide6-Fluent-Widgets`（自定义图片 JPG/BMP 可选 Pillow、光机控制可选 pyserial）；
|
||||
EDID-viewer GUI 需 `py -m pip install -r EDID-viewer/requirements.txt`（PySide6 + PySide6-Fluent-Widgets）；
|
||||
SerialMate GUI 需 `py -m pip install PySide6 PySide6-Fluent-Widgets pyserial`；
|
||||
I2C-Inject 需 `py -m pip install pyserial`
|
||||
- 重新打包：`DLPilot/src/build_exe.py`（自动安装 PyInstaller）；I2C-Inject 目录内 `python build_exe.py`
|
||||
- 重新打包：`DLPilot/src/build_exe.py`、`EDID-viewer/src/build_exe.py` 与
|
||||
`SerialMate/src/build_exe.py`（均自动安装 PyInstaller）；I2C-Inject 目录内 `python build_exe.py`
|
||||
|
||||
## 目录结构
|
||||
|
||||
每个工具内统一三区：**src/ 源代码（人写）** → **assets/ 生成资产（可再生成）** →
|
||||
**release/ 打包与发布产物（机器生成）**；README.md 面向使用者，AGENTS.md 面向 AI/Agent（工程约定与构建规程）。
|
||||
**release/ 打包与发布产物（机器生成）**；README.md 面向使用者，AGENTS.md 记录工程约束与开发进度，
|
||||
仓库整体的开发需求与进度管理见根目录 `agent.md`。
|
||||
|
||||
```
|
||||
LT8619C_Debug_Tools/
|
||||
HW-Debug-Tools/
|
||||
├── DLPilot/
|
||||
│ ├── src/ # 源码 + 打包/发布脚本 + 图标源
|
||||
│ ├── assets/ # 生成的测试图案 PNG（gen_*.py 产物）
|
||||
│ ├── release/ # 打包 exe + 运行配置（入库）；发布 zip（不入库）
|
||||
│ ├── README.md # 使用说明
|
||||
│ └── AGENTS.md # AI/Agent 工程档案
|
||||
│ └── AGENTS.md # 工程档案
|
||||
├── EDID-viewer/
|
||||
│ ├── src/ # 界面/解析/WMI 读取 + 打包/发布脚本
|
||||
│ ├── assets/ # 图标与生成脚本
|
||||
│ ├── release/ # EDID-Viewer.exe + README（入库）；发布 zip（不入库）
|
||||
│ ├── README.md # 使用说明
|
||||
│ └── AGENTS.md # 工程档案
|
||||
├── SerialMate/
|
||||
│ ├── src/ # 协议/串口线程/曲线控件/GUI + 自检 + 打包/发布脚本
|
||||
│ ├── release/ # SerialMate.exe + README（入库）；发布 zip（不入库）
|
||||
│ ├── README.md # 使用说明
|
||||
│ └── AGENTS.md # 工程档案
|
||||
├── I2C-Inject/ # PC 端 GUI + RP2040 固件 + 打包 exe + 图标 + README
|
||||
├── gd32e230f8_firmware_merge_tool/ # 🔗 git 子模块 → GD32E230 固件工具（独立仓库，见下方备注）
|
||||
├── LICENSE
|
||||
└── README.md
|
||||
```
|
||||
|
||||
## 发布流程（DLPilot）
|
||||
## 发布流程（DLPilot / EDID-Viewer / SerialMate 同一套流水线）
|
||||
|
||||
```powershell
|
||||
cd DLPilot/src
|
||||
python build_exe.py # 打包 → ../release/DLPilot.exe
|
||||
python package_release.py <版本> # → ../release/DLPilot-v<版本>-win64.zip
|
||||
python publish_gitea.py DLPilot-v<版本>-win64.zip --insecure # 上传 Gitea Release(需 GITEA_TOKEN)
|
||||
cd DLPilot/src # 或 EDID-viewer/src、SerialMate/src
|
||||
python build_exe.py # 打包 → ../release/<工具>.exe
|
||||
python package_release.py <版本> # → ../release/<工具>-v<版本>-win64.zip
|
||||
python publish_gitea.py <工具>-v<版本>-win64.zip --insecure # 上传 Gitea Release(需 GITEA_TOKEN)
|
||||
```
|
||||
|
||||
每个工具独立打标签发布（`DLPilot-v*` / `EDID-Viewer-v*` / `SerialMate-v*`），Release 列表按时间倒序混排于同一页面。
|
||||
|
||||
## 备注
|
||||
|
||||
- 源码与打包产物（exe、pattern_slots.json）均入库；发布 zip 不入库，只上传 Gitea Release
|
||||
- `gd32e230f8_firmware_merge_tool/` 是 git 子模块（[独立仓库](https://gitea.hulk.wang/hulk/gd32e230f8_firmware_merge_tool)，
|
||||
代码与发布均在其仓内管理，本仓只锁定指针）：
|
||||
新克隆后需 `git submodule update --init` 拉取内容；
|
||||
跟进其最新版用 `git submodule update --remote gd32e230f8_firmware_merge_tool`，随本仓提交新指针
|
||||
- 两件工具的寄存器语义（0x606E 位交换 / 0x606D 整组顺序）均经 demo 板逻辑分析仪
|
||||
双色交叉实测，过程数据与规程存于上游主仓库 `doc/architecture/`
|
||||
- 更新：2026-09-24
|
||||
- 更新：2026-09-30
|
||||
|
||||
@@ -0,0 +1,293 @@
|
||||
# AGENTS.md — SerialMate 工程档案（开发约束与进度）
|
||||
|
||||
> 人类文档 [README.md](README.md) 回答"这是什么、怎么用"；本文记录"代码怎么组织、
|
||||
> 怎么构建发布、改动时哪些约束不能破坏"，兼作本工具的进度记录。
|
||||
> 修改本目录代码前先读完本文。仓库整体的开发需求与进度管理见根目录 `agent.md`。
|
||||
|
||||
## 1. 项目定位
|
||||
|
||||
仓库 `HW-Debug-Tools` 是 LT8619C→DLPC3421 投影转接板的调试上位机工具集。
|
||||
SerialMate 是其中的**通用串口/RS485 调试助手**：收发 + 协议解析 + 曲线。
|
||||
默认帧格式与 DLPilot 光机 RS485 协议完全一致（`D5 01 LEN <payload> CRC`），
|
||||
可直接调试板载 GD32E230 网关；帧格式（包头/板ID/CRC 算法与覆盖范围）可定制，
|
||||
适配任意"包头+板ID+LEN(=payload长度)+payload+CRC"五段式协议。
|
||||
协议语义权威同 DLPilot：上游固件仓 `protocols.md`，本仓不维护副本。
|
||||
|
||||
## 2. 目录契约
|
||||
|
||||
```
|
||||
SerialMate/
|
||||
├── src/ 源代码区 —— 只有这里可以手改
|
||||
├── release/ 产物区 —— SerialMate.exe + README.md（入库），
|
||||
│ *-win64.zip（gitignore，只上传 Release）
|
||||
├── assets/ 图标等生成资产（暂无；build_exe.py 已预留 assets/serial-mate.ico）
|
||||
├── README.md 人类文档
|
||||
└── AGENTS.md 本文
|
||||
```
|
||||
|
||||
### 文件角色速查
|
||||
|
||||
| 文件 | 角色 |
|
||||
|---|---|
|
||||
| `src/main.py` | Fluent GUI 入口（含 `--seconds N` 冒烟参数），argparse 仅此一处 |
|
||||
| `src/protocol.py` | 协议模块（纯标准库）：FrameLayout 帧构成令牌、ProtoConfig 组帧/校验、FrameParser 增量解析、CRC 算法表、extract_value 数值提取 |
|
||||
| `src/link.py` | 串口工作线程 SerialLink（pyserial 只准在这里 import），支持 `loop://` 虚拟回环 |
|
||||
| `src/plot.py` | 滚动曲线控件（纯 QPainter，刻意不引 matplotlib/pyqtgraph） |
|
||||
| `src/config.py` | BASE_DIR 定位与 serial_mate.json / board_profiles.json 读写（缺键补默认，读容错） |
|
||||
| `src/theme.py` | 主题三件套同步（Fluent setTheme + QPalette/QSS + DWM 标题栏），与 EDID-Viewer 同源 |
|
||||
| `src/selftest.py` | 协议自检（无依赖、无硬件，改 protocol.py 后必跑） |
|
||||
| `src/selftest_loop.py` | 链路自检（loop:// 回环验证 组帧→发送→接收→解析→提取，缺 pyserial 跳过） |
|
||||
| `src/selftest_gui.py` | GUI 功能自检（offscreen 驱动事件处理函数：预览/回显/提取/配置往返，改 main.py 后建议重跑） |
|
||||
| `src/build_exe.py` | PyInstaller onefile 打包 → `release/SerialMate.exe` |
|
||||
| `src/package_release.py` | exe+README → `release/SerialMate-v<版本>-win64.zip` |
|
||||
| `src/publish_gitea.py` | 建/复用 Gitea Release 并上传 zip（`GITEA_TOKEN`，需 `--insecure`） |
|
||||
|
||||
## 3. 代码不变量（改代码必须维持）
|
||||
|
||||
1. **依赖分层**：protocol.py / config.py 纯标准库；pyserial 只准在 link.py
|
||||
import（main.py 经 `SerialLink` 间接使用）；plot.py 只依赖 PySide6；
|
||||
GUI 硬依赖 PySide6-Fluent-Widgets + pyserial（串口工具缺 pyserial 即无意义，
|
||||
与 DLPilot 的"缺失降级"策略不同，只保留 try-import 提示）。
|
||||
1a. **卡片布局约定**：`_card(side=True)` 把短副标题放标题右侧省一行（串口/
|
||||
协议/发送卡）；右列是纵向 QSplitter（接收/发送高度用户可拖拽，拉伸余量
|
||||
默认给接收、发送卡保持自然高度防空腔）；发送卡末尾 `lay.addStretch(1)`
|
||||
保证内容贴顶（卡片被拖高后富余高度收在卡底，勿删——否则拉伸被各行均分,
|
||||
标题上方出现空隙）；发送卡行序：板型管理行(下拉+新建+删除+配置+重载) /
|
||||
预设行(下拉+填入+直接发送) / 模式行(下拉+存为板型+存入预设) / 输入行 /
|
||||
周期行；帧日志 payload 高亮走 `_append_rx_frame`（`_esc_log` 转义后拼 span
|
||||
背景，toPlainText 内容不变，selftest 的日志断言因此不受影响）；预设下拉
|
||||
显示"名称 · 命令"，存入命令走 `_add_command_named`（弹窗核 `_add_command`
|
||||
包装，测试用核函数），预设直发走 `_send_preset_direct`（经输入框复用
|
||||
组帧/历史链路）。
|
||||
1b. **窗口最小高度**：首帧布局后 `_apply_minimum_size` 按内容实际最小高度
|
||||
抬高窗口下限（高度拉过矮时布局约束无法满足，曲线卡绘图区会被压塌并与
|
||||
通道行互相叠压——用户实测）；勿删, 调整曲线卡行数/高度后该值自动跟随。
|
||||
2. **回调线程边界**：SerialLink 的 on_status/on_frame/on_raw/on_tx 全在后台线程
|
||||
触发，一律 `events.put(...)` 投递，主线程 30ms QTimer 轮询 `_drain_events`
|
||||
分发（与 DLPilot `_poll_dlpc` 同模式），禁止回调里直接碰 GUI。
|
||||
**时间戳由 link 后台线程打**（字节到达/写入串口时刻）：四个回调签名均带
|
||||
尾参 ts 并随事件入队（事件元组尾部即 ts，如 `('frame', fr, ts)`）——GUI
|
||||
消费侧只经 `_timestamp(t)` 格式化、不现取（消费时刻打戳会随 UI 卡顿成批
|
||||
挤压失真，v0.1.0 教训，见 `ISSUE_rx_timestamp_and_lag.md`）。
|
||||
2b. **接收日志治理**：日志行只入 `_rx_buf`（`_append_rx`/`_append_rx_frame`
|
||||
负责转义），`_drain_events` 末尾 `_flush_rx` 一次 appendHtml——每行必须包
|
||||
`<p style="margin:0">`（**`<br>` 连接只算 1 个 block，会让
|
||||
maximumBlockCount 裁旧行失效**，offscreen 实验验证过）；转义用 `_esc_log`
|
||||
（空格转 ` `，防富文本折叠连续空格破坏 TX 行对齐）；`_update_counters`
|
||||
由 drain 末尾统一调一次，勿回到每帧调用。事件积压超 `FOLD_QSIZE`(200) 时
|
||||
该批帧走 `_absorb_frame`（曲线照常入库、计数器照常，日志折叠为带首尾到达
|
||||
时刻的计数摘要行，消化到阈值内自动恢复逐帧）。
|
||||
2c. **通道配置缓存**：`_on_frame` 帧路径只读 `self._ch_cfg`（`_on_channel`
|
||||
用户改动配置时经 `_collect_channels` 重建），禁止每帧遍历 UI 控件读配置
|
||||
（高频时放大 UI 线程占用，v0.1.0 延迟累积的帮凶之一）。
|
||||
3. **半双工节奏**：link 工作线程每个循环周期最多出队写一帧（20ms 间隔），
|
||||
RS485 总线多帧连发留应答间隙，勿改成批量 drain 一次写。
|
||||
4. **帧构成语义**：帧由 `FrameLayout` 令牌序列定义（`HDR ID LEN PAYLOAD CRC`
|
||||
令牌 + 十六进制字面量，收发共用布局、仅包头值分方向）；约束：LEN/PAYLOAD/CRC
|
||||
恰好各一次、CRC 必须最后、LEN 前至少一个 HDR 或字面量（同步定界）、ID 最多一次。
|
||||
LEN 口径（`LEN_SEMS`）：payload 长度 / 到帧尾(payload+CRC) / 整帧；
|
||||
CRC 算法/覆盖范围见 protocol.CRC_ALGOS/CRC_SCOPES，覆盖按**帧内位置**定义
|
||||
（with_header=第1字节起 / no_header=跳过第1字节 / payload_only=仅载荷），
|
||||
任意布局通用；2 字节 CRC 线上字节序 MODBUS 低前、其余高前，按算法约定单序
|
||||
校验（改动需同步 selftest 向量）。
|
||||
5. **解析重同步策略**：前缀令牌逐位对齐（HDR/字面量须匹配、ID 通配），LEN 值经
|
||||
口径换算为 payload 长度，负值视为伪帧头逐出；CRC 失配丢 1 字节重同步——
|
||||
通用工具不预设合法 LEN 区间（与 DLPilot 的 LEN 范围预判不同）。
|
||||
6. **ID 位不校验只透出**：`Frame.code` 原样上抛（布局无 ID 时为 None，GUI 日志
|
||||
与 selftest 均需兼容 None），TYPE_NAMES 仅用于显示译码（DLPilot 语义）。
|
||||
7. **BASE_DIR 语义**（config.py）：frozen 时 =exe 所在目录，源码运行时 =src/；
|
||||
设置平铺存 `serial_mate.json`，不建子目录。`tx.periodic` 不随配置
|
||||
自动启动（防误连发），其余配置启动恢复。
|
||||
8. **曲线数据流**：每帧对每个启用通道调 `extract_value`（失败静默跳过），
|
||||
`PlotWidget.add` 内部 deque(maxlen=3000) 滚动丢弃；数值格式统一
|
||||
`fmt_val`（4 位有效数字）。
|
||||
9. **主题**：theme.py 三件套同步（见 EDID-Viewer 教训：只 setTheme 会黑块）；
|
||||
plot 曲线颜色固定 4 色，文字/网格色取自 QPalette 自动跟随明暗。
|
||||
9a. **曲线时间窗**：PlotWidget 持有 `_span`(窗宽秒, None=跟随全部) 与
|
||||
`_offset`(右端距最新秒数, 0=实时)；横轴域换算在 `visible_domain`(纯计算,
|
||||
selftest 有断言)。**窗口不向数据收敛**(用户实测反馈)：选 5min 而数据只有
|
||||
23s 时显示完整 5min 轴、曲线贴右端随采集填满(示波器式)，右下角标注
|
||||
"已采集 Xs / 窗口 Ns"；滞后超出全部历史 = 空窗保宽。弹窗内 时间窗下拉+
|
||||
滑条 只改这两个状态；滑条 0..1000 线性映射 (1000-v)/1000×maxpan，实时
|
||||
跟随=拉到最右(1000)；poll 定时器 `_sync_time_slider` 回写位置(用户拖动中
|
||||
跳过)；嵌回卡片时强制重置为跟随全部(卡内无滑条, 防困在滞后窗里)。纵轴
|
||||
数值刻度画在每条横向参考线上。
|
||||
悬停读值：mouseTracking 开启, mouseMove 只记录 `_hover_pos` 并请求重绘；
|
||||
读值内容由 paintEvent **每帧**经 `_hover_lines_at(_hover_pos)` 重算(光标
|
||||
时间 T 经 `_plot_geometry` 换算, `_nearest` 二分取 ±10px 容差内最近采样),
|
||||
画在顶部居中反色小框(`_hover_box`)——鼠标停住不动时数值也随实时数据持续
|
||||
刷新(勿改回 mouseMove 里一次性算好/或 QToolTip, 那样不动鼠标就不更新——
|
||||
用户实测反馈)。`_nearest`/`_hover_lines_at` 有单测。绘图区内边距统一用
|
||||
`M_LEFT/TOP/RIGHT/BOTTOM` 类常量(绘制与鼠标换算共用, 勿在 paint 里另写)。
|
||||
9b. **暂停(两级语义)**：主界面"暂停"= `_paused`, add() 丢弃暂停期间的数据；
|
||||
弹窗"暂停渲染"= `_frozen`, 数据照常入库但跳过重绘——冻结是**绝对状态**:
|
||||
PlotWidget 覆写 `update()` 直接吞掉一切重绘请求(任何代码路径都无法在
|
||||
冻结期打破), 只有 `set_frozen(False)` 恢复并一次性渲染积累；冻结时画面
|
||||
中央显示"已冻结渲染(采集继续)"角标让状态可见。两者互不干扰, 均有
|
||||
selftest 断言。
|
||||
9c. **弹窗曲线交互**：自动Y(勾选按钮, 与主界面 chk_auto_y 双向同步, 关闭时
|
||||
以 `auto_yrange()` 初始化手动量程)；图上左键拖动 = 平移手动 Y 量程
|
||||
(`on_yrange_changed` 回调同步主界面 Ymin/Ymax 输入框, 阻断信号防回环)；
|
||||
滚轮 = 缩放时间窗 2~900s(滞后按比例缩放, 经 `on_span_changed` 回调让
|
||||
`_sync_time_slider` 把时间窗下拉同步为匹配档位/自定义(-1))；"实时"按钮
|
||||
= offset 归零跳回最新。自动 Y 量程抽取为 `auto_yrange()`(纯计算, 有单测)。
|
||||
11a. **曲线弹出窗口**：绘图区在曲线卡留有固定槽位布局 `_plot_slot`，弹出 =
|
||||
`setParent(None)` 后装入顶层窗口（通道/暂停/Y 轴控件留在主界面控制同一
|
||||
PlotWidget 实例）；关掉弹出窗口（eventFilter 捕 Close）或主窗 closeEvent
|
||||
都会走 `_dock_plot()` 嵌回 —— `_dock_plot` 必须先摘 `self._plot_win` 引用
|
||||
再 `win.close()`（防 Close 递归），且 `setParent(None)` 后必须补 `show()`
|
||||
（重挂布局不会自动恢复可见）。
|
||||
10. **多实例**：有意不加单实例锁（双口双开的合法场景），串口冲突靠
|
||||
pyserial 报错提示（"串口被占用"文案在 link.py，勿删）。
|
||||
11. **板型档案**：`board_profiles.json`（BASE_DIR 平铺，用户本机数据不入库，
|
||||
首次运行自动生成默认"DLPilot光机"）。档案 = name + proto(7 个帧协议字段，
|
||||
**不含 parse** —— 解析开关是查看偏好) + commands[[名,命令]..]；切换板型
|
||||
应用协议参数并装载命令表，"存入"命令以命令文本为名去重；启动恢复选中
|
||||
板型时**只装载命令表不重复应用协议参数**（协议以上次会话 store 为准）；
|
||||
GUI 增删后经 config.save_profiles 落盘，"配置/重载"支持手改 JSON。
|
||||
|
||||
## 4. 构建与发布（全部在 src/ 下执行）
|
||||
|
||||
```powershell
|
||||
python -m compileall -q . # 全模块可编译
|
||||
python selftest.py # 协议回归(47 项, 改 protocol.py 后必跑)
|
||||
python selftest_loop.py # 链路回环(需 pyserial, 改 link.py 后必跑)
|
||||
python selftest_gui.py # GUI 功能回归(offscreen, 改 main.py 后建议重跑)
|
||||
python main.py --seconds 5 # GUI 冒烟(源码); offscreen: set QT_QPA_PLATFORM=offscreen
|
||||
python build_exe.py # → ../release/SerialMate.exe(缺 PyInstaller 自动装)
|
||||
python package_release.py <版本> # → ../release/SerialMate-v<版本>-win64.zip
|
||||
python publish_gitea.py ../release/SerialMate-v<版本>-win64.zip --replace --insecure
|
||||
```
|
||||
|
||||
发布约定与 Gitea 实例怪癖（TLS 抽风加 `--insecure`、assets 两种形状兼容、
|
||||
token 读 `GITEA_TOKEN` 用户级环境变量）同 DLPilot，详见 `DLPilot/AGENTS.md` §5；
|
||||
tag/release 命名 `SerialMate-vX.Y.Z`，zip 命名
|
||||
`SerialMate-vX.Y.Z-win64.zip`（publish_gitea.py 从文件名推 tag）。
|
||||
|
||||
## 5. 已知坑（本工具踩过/继承的）
|
||||
|
||||
- `qfluentwidgets.CaptionLabel` 无 `setDim` 方法（本机版本），灰字用
|
||||
`CaptionLabel` 本身即可；`ComboBox` 不要用 `currentData`（qfluentwidgets
|
||||
自绘下拉 userData 支持不稳），一律 currentIndex + 平行元组映射。
|
||||
- **qfluentwidgets 控件默认水平 Expanding**：紧凑行不设 stretch 项时空白会被
|
||||
CheckBox/Label 等瓜分出大空隙 —— 一律走 `Window._row()`（行尾默认补
|
||||
stretch；Qt 规则：有 stretch 因子时额外空间只按因子分配），需要自管拉伸的
|
||||
行传 `trailing=False`。
|
||||
- **qfluentwidgets SpinBox/DoubleSpinBox 设固定宽后内部行编辑器会塌缩**
|
||||
（minimumSizeHint 142/193 只是参考，强设小于它的宽度时行编辑器只剩几像素,
|
||||
数值被裁成残字——整数 0 在 96px 时渲染成 "]"）：整数 SpinBox ≥110px、
|
||||
DoubleSpinBox ≥130px 才能完整显示数值；曲线卡偏移/序号/倍率/Y 量程框的
|
||||
宽度有 selftest 断言把守, 调布局时勿低于阈值。
|
||||
- 组帧/解析回路自测时必须让 `tx_hdr == rx_hdr`（收发方向包头本就允许不同，
|
||||
D5 组的帧 B5 解析器看不见——selftest 的 fuzz/回路用例已按此约定）。
|
||||
- offscreen 冒烟报 `QFontDatabase: Cannot find font directory` 属 Qt offscreen
|
||||
平台噪音，桌面运行无此问题，勿当 bug 修。
|
||||
- onefile 运行时定位 exe 用 `sys.executable`（`__file__` 在 `_MEIPASS`），
|
||||
config.py 已按此实现。
|
||||
|
||||
## 6. 验证清单（改完代码后）
|
||||
|
||||
1. `python -m compileall -q .` —— 全模块可编译；
|
||||
2. `python selftest.py` —— 协议回归（改 protocol.py 后必跑）；
|
||||
3. `python selftest_loop.py` —— 链路回环（改 link.py 后必跑）；
|
||||
4. `python main.py --seconds 5` —— GUI 冒烟自动开关；
|
||||
5. `python build_exe.py` → 双击 release/SerialMate.exe 确认界面渲染；
|
||||
6. （有硬件时）USB-RS485 接光机发 M1/M201/M731 验证真机收发与曲线。
|
||||
|
||||
## 7. 进度记录
|
||||
|
||||
### v0.1.1（2026-10-10，接收路径修复：时间戳失真 + 显示延迟累积）
|
||||
|
||||
背景：FilmForge 固件联调（GD32F405 RS485 115200，M2 连续温度上报 2~10 帧/s）
|
||||
发现日志时间戳成批挤压、显示延迟越跑越大；固件侧二分验证 100% 出帧，问题
|
||||
独立存在于 SerialMate 显示层，见 `ISSUE_rx_timestamp_and_lag.md`。
|
||||
|
||||
已完成：
|
||||
- **根因 1**（时间戳在 GUI 消费时刻打）：时间戳改在 link 后台线程打
|
||||
（字节到达/写入串口时刻），`on_status/on_frame/on_raw/on_tx` 签名均追加
|
||||
尾参 ts 并随事件入队；`_timestamp(t)` 变为纯格式化函数。日志时间恢复为
|
||||
真实到达时间。
|
||||
- **根因 2**（接收日志无限增长 → UI 递减性卡顿 → 延迟累积）：
|
||||
- 接收日志批量插入：`_drain_events` 把本轮日志行攒入 `_rx_buf`，末尾
|
||||
`_flush_rx` 一次 appendHtml（每行一个 `<p style="margin:0">`，
|
||||
maximumBlockCount 裁旧行照常生效；`_esc_log` 空格转 ` ` 防富文本
|
||||
折叠连续空格）；`_update_counters` 改为 drain 末尾统一一次；
|
||||
- 通道配置缓存 `_ch_cfg`：`_on_channel` 时重建，帧路径不再每帧遍历控件
|
||||
（提取逻辑收敛进 `_extract_channels`）；
|
||||
- 积压折叠：事件队列超 `FOLD_QSIZE`(200) 时该批帧走 `_absorb_frame`——
|
||||
曲线照常入库、计数器照常，日志折叠为一行计数摘要（含首尾到达时刻，
|
||||
如 `← 12:00:00.100~12:00:02.300 ⏳ 显示滞后, 折叠 250 帧: B=0xF0 温度
|
||||
上报 ×250`），消化到阈值内自动恢复逐帧；
|
||||
- 行数上限 5000（v0.1.0 末期已加的止血，本次提为常量 `RX_MAX_BLOCKS`）。
|
||||
- 自检扩充：selftest_loop 增回调 ts 断言共 18 项；selftest_gui 增时间戳
|
||||
格式化/帧日志用到达时刻/通道缓存同步/积压折叠 8 项共 69 项；另做端到端
|
||||
模拟（600 帧积压一次性消费）：日志压到 201 行、曲线 600 点全收、时间戳
|
||||
单调且逐帧等于真实到达时刻。
|
||||
- README 接收显示段同步时间戳/日志治理语义；exe 重建入库（v0.1.1）；
|
||||
zip/Release 未发布（待用户验收）。
|
||||
- **真机 M2S100"卡住"排查（2026-10-10，用户复测反馈）**：用户 v0.1.1 exe
|
||||
发 M2S100 后 ack 与周期帧均不显示。本机分层复现均正常——裸 pyserial+
|
||||
解析器（帧 100% 到达、ack ok、100ms 间隔稳）、offscreen GUI 全链路
|
||||
（60 帧/6s 一帧不丢）、桌面真渲染完整用户序列（连接→M1/M2→M2S100→帧流，
|
||||
138 帧全显示）。exe 经归档解包确认含 v0.1.1 代码。未能复现，定性为
|
||||
用户端环境/运行态问题，待用户按状态栏"积压"指示再复现时定位。
|
||||
排查副产品：
|
||||
- link.py 串口参数加 `inter_byte_timeout=0.02`（Win32
|
||||
ReadIntervalTimeout）——注意 **pyserial 的 timeout 是总超时**（150ms 内
|
||||
必返回，不无限攒批），此参数把周期帧的 read 粒度从 ~150ms 一批改善为
|
||||
单帧粒度（帧时间戳更准）；
|
||||
- 状态栏计数器追加 **积压 N**（events.qsize()）——常驻分层观测：数字
|
||||
持续增长=事件产出快于消费（GUI 侧问题），恒 0=RX 链路断（串口/驱动/
|
||||
固件侧问题）；"卡住"时 UI 整体无响应则是主线程被阻塞，另查。
|
||||
- 勘误：修复初期曾把 M2S100 卡住归因"read(4096) 攒批 41 秒"，该论述
|
||||
错误（win32 timeout 为总超时），已修正注释；loop:// 虚拟口的 read
|
||||
立即返回缓冲，**测不出真串口等待行为**，链路自检覆盖不到此处。
|
||||
- 探测善后：COM5 FilmForge 固件曾残留 100ms 上报态（用户上次 M2S100
|
||||
生效的证据），已发 M2S0 关闭（M2 查询=OFF）。
|
||||
|
||||
待办 / 计划：无新增，沿用 v0.1.0 待办。
|
||||
|
||||
### v0.1.0（2026-09-27，首版）
|
||||
|
||||
已完成：
|
||||
- 协议模块：**帧构成令牌序列可定制**（`HDR ID LEN PAYLOAD CRC` 令牌 + 十六进制
|
||||
字面量同步字节，收发共用布局，支持字段换序/无板ID/多字节同步头；LEN 口径三种：
|
||||
payload 长度 / 到帧尾 / 整帧）、5 种 CRC 算法 × 3 种覆盖范围（按帧内位置定义，
|
||||
任意布局通用）、增量解析（前缀逐位对齐 + CRC 失败逐字节重同步）、
|
||||
二进制/文本/正则三种曲线数值提取；自测 64 项全 PASS（含 DLPilot 实测帧向量、
|
||||
CRC 标准校验值 check("123456789")、布局换序/字面量/LEN 口径向量与布局模糊往返）。
|
||||
- 串口链路：参数热切换、发送队列（半双工友好 + 未连接丢弃）、解析/透传双模式
|
||||
热切、`loop://` 虚拟回环自检 13 项全 PASS（组帧→发送→接收→解析→曲线提取）。
|
||||
- GUI（PySide6-Fluent-Widgets）：串口/协议/曲线/接收/发送五卡，帧构成与 LEN 口径
|
||||
可视化编辑（非法输入即时提示），payload 字符串/HEX 切换（帧日志的 payload
|
||||
段垫半透明底色高亮——主题无关 rgba, 明暗切换不残留, 经 appendHtml 实现）、
|
||||
原始帧 hex、时间戳、日志保存；发送：自动包装（`/` 分隔多条）、HEX 直发、
|
||||
周期发送、组帧实时预览、历史回溯（↑↓）、回车发送；主题跟随系统。
|
||||
- 曲线（plot.py + 弹窗，2026-09-27 实机反馈多轮迭代）：4 通道三种提取方式 +
|
||||
倍率，自动/手动 Y 量程；绘图区可**弹出独立窗口**（嵌回自动重置视图）；
|
||||
纵轴每条参考线标数值刻度；时间窗（跟随/10s~15min, 示波器式不向数据收敛,
|
||||
右下角"已采集/窗口"标注）+ 横向滑条回看历史；悬停读值框固定顶部、鼠标
|
||||
不动也随数据持续刷新；**暂停渲染**（冻结显示继续收数, 与主界面"暂停"
|
||||
两级语义, 冻结有中央角标）；自动Y 开关、图上拖动自定义 Y 轴（同步主界面
|
||||
输入框）、滚轮缩放时间窗（2~900s）、实时按钮；窗口最小高度按内容自适应
|
||||
（防高度拉小时通道行叠压绘图区）。
|
||||
- 板型档案：发送卡"板型"下拉一键切换协议参数 + 命令预设；**新建板型**（协议
|
||||
沿用当前、命令预设空白，防遗留其他板子的命令）/存为板型（同名覆盖）/
|
||||
**删除板型**（确认弹窗，至少保留一个，删除后切第一个板型且协议参数不动）/
|
||||
存入预设命令（弹窗自定义显示名称）/配置=内嵌表格编辑器（**CommandTable**：
|
||||
第 0 列 ≡ 手柄按住上下拖动整行排序——内部 QDrag，move_row 整行搬移；
|
||||
网格线/隔行底色按 palette 明暗自适配，空行清晰可见；+加行 −删行；空命令与
|
||||
重复命令保存时忽略/去重，写回 board_profiles.json）/重载；预设下拉
|
||||
"名称 · 命令"同显。
|
||||
- 发布流水线：build_exe/package_release/publish_gitea 与全仓一致；exe 已重建
|
||||
入库，zip/Release 未发布（待用户验收）。
|
||||
|
||||
待办 / 计划：
|
||||
- 【无图标】assets/serial-mate.ico 未生成（build_exe.py 已预留路径，
|
||||
参照 DLPilot logos/make_ico.py 流程补）。
|
||||
- 【真机已过】用户已实机联调（COM15 真机收发/曲线提取/多板型档案实际使用,
|
||||
2026-09-27 多轮界面反馈即来自真机数据）；温度曲线量纲（倍率取值）待用户
|
||||
按传感器手册确认。
|
||||
- 【计划】发送区多条 payload 的"批处理脚本"化（延时/循环/条件等待应答）。
|
||||
- 【计划】曲线数据导出 CSV；接收日志按日期自动分文件。
|
||||
- 【考虑】CRC 解析侧双字节序兼容开关（当前按算法约定单序）。
|
||||
@@ -0,0 +1,97 @@
|
||||
# SerialMate 接收路径问题报告（时间戳失真 + 显示延迟累积）
|
||||
|
||||
> 来源：FilmForge 固件联调（GD32F405 RS485，115200，M2 连续温度上报 2~10 帧/s）。
|
||||
> 现象与固件侧二分验证结论一起整理，供后续修复。
|
||||
> 日期：2026-10-10
|
||||
>
|
||||
> **【已修复 v0.1.1，2026-10-10】** 根因 1 与根因 2 的 1/2/3/4 全部落地，
|
||||
> 实现与本文建议的差别：日志批量插入每行包 `<p style="margin:0">`（`<br>`
|
||||
> 连接只算 1 个 block，会让 maximumBlockCount 失效）；转义空格转 ` `
|
||||
> 防富文本折叠连续空格；通道缓存放 `_ch_cfg`（`_on_channel` 时重建）。
|
||||
> 自检已覆盖（selftest_gui 69 项含积压折叠/到达时间戳用例），
|
||||
> 端到端模拟 600 帧积压：日志 201 行、曲线 600 点全收、时间戳=到达时刻。
|
||||
> 详见 AGENTS.md §7 v0.1.1。
|
||||
|
||||
## 现象（联调实测）
|
||||
|
||||
1. **时间戳挤压**：M2 以 500ms/100ms 周期上报时，日志里出现 13 帧"0.2~1ms 间隔"
|
||||
挤在同一批（如 23:59:55.221~227），完全不是真实到达间隔。
|
||||
2. **显示延迟累积**：命令 ack 延迟 120~160ms 才显示；长时间运行后越来越卡，
|
||||
最终表现为"命令发了没反应"（实际帧在队列里排队，晚些时候才显示）。
|
||||
3. **偶发"丢帧"观感**：与 2 叠加后，ack 迟迟不显示，上位机/人工判断为无响应。
|
||||
|
||||
固件侧已用调试串口镜像做过二分验证：**帧到达固件、固件发出响应均为 100%**，
|
||||
SerialMate 显示层的时间戳与延迟失真是独立存在的第二层问题。
|
||||
|
||||
## 根因 1：时间戳在 GUI 消费时刻打，而非字节到达时刻（确凿）
|
||||
|
||||
- `link.py` `_dispatch_rx()` 后台线程解析出帧后回调 `on_frame(fr)`；
|
||||
- `main.py:237` `self.link.on_frame = lambda fr: self.events.put(('frame', fr))`
|
||||
—— **入队时不带时间戳**；
|
||||
- `main.py:1291` `_on_frame()` 里才调 `_timestamp()` —— **消费时打戳**。
|
||||
|
||||
后台读线程 20ms 轮询、GUI QTimer 30ms drain，再叠加 UI 卡顿，一串积压帧的
|
||||
时间戳全部落在消费瞬间，毫秒级挤在一起。**这不是到达时间，是显示时间。**
|
||||
|
||||
### 修复建议
|
||||
|
||||
时间戳统一在 link 后台线程产生（字节到达时刻），随事件入队：
|
||||
|
||||
```python
|
||||
# link.py _dispatch_rx()
|
||||
ts = time.time() # 或 time.perf_counter()
|
||||
for fr in self.parser.feed(data):
|
||||
if self.on_frame is not None:
|
||||
self.on_frame(fr, ts) # 携带到达时刻
|
||||
# raw 同理: self.on_raw(data, ts)
|
||||
|
||||
# main.py
|
||||
self.link.on_frame = lambda fr, ts: self.events.put(('frame', fr, ts))
|
||||
...
|
||||
def _on_frame(self, fr, ts): # 显示时用 ts 格式化，不再调 _timestamp()
|
||||
```
|
||||
|
||||
`on_raw` / `on_tx`（若也要求发送时刻）/ `on_status` 同理改造。
|
||||
`_timestamp()` 改为接受 epoch 秒参数的纯格式化函数。
|
||||
|
||||
## 根因 2：接收日志无限增长 → UI 递减性卡顿 → 延迟累积（确凿）
|
||||
|
||||
- `_append_rx`/`_append_rx_frame` 对 `text_rx` 逐行 `appendPlainText/appendHtml`，
|
||||
**无任何行数上限**。长跑后 QPlainTextEdit 文档越滚越大，排版/paint 成本上升，
|
||||
30ms 的 `_drain_events` 开始处理不完，事件积压，显示延迟越拉越大。
|
||||
- `_on_frame` 每帧调用 `_collect_channels()`（遍历全部通道 UI 控件读
|
||||
isChecked/text/value），帧率高时放大 UI 线程占用。
|
||||
|
||||
### 修复建议
|
||||
|
||||
1. 行数上限：`self.text_rx.setMaximumBlockCount(5000)`（一行代码，先止血）；
|
||||
或定时（如每 5s）裁剪超量历史。
|
||||
2. 批量插入：`_drain_events` 把本轮全部行拼成一个字符串/HTML 片段，**一次**
|
||||
append，减少 N 次 UI 重排为 1 次。
|
||||
3. 通道配置缓存：维护 `self._ch_cfg`，仅在 `_on_channel`（用户改动配置）时
|
||||
重建；`_on_frame` 直接读缓存，不再每帧遍历控件。
|
||||
4. 帧率自适应：积压超过阈值（如 events.qsize() > 200）时，帧日志折叠为
|
||||
计数摘要（"…+250 帧 (温度上报)"），保曲线、压日志。
|
||||
|
||||
## 排除项（验证过没有问题）
|
||||
|
||||
- `protocol.FrameParser`（前缀对齐 + LEN + CRC，失配丢 1 字节重同步）解析器
|
||||
本身健壮，未发现丢帧逻辑缺陷；`src/selftest.py` 覆盖良好。
|
||||
- `events = queue.Queue()` 无上限，不会丢事件，只会延迟。
|
||||
- `link.py` 读线程 20ms 轮询 + `read(4096)`，常规速率下不会溢出驱动缓冲
|
||||
（115200 下 20ms 最多 288 字节）。
|
||||
|
||||
## 优先级建议
|
||||
|
||||
1. 先做根因 2 的"1. 行数上限"（一行代码）——立刻止血卡顿。
|
||||
2. 再做根因 1 的时间戳随事件携带——日志时间恢复可信。
|
||||
3. 根因 2 的 2/3/4 与根因 1 的状态/tx 同步改造，作为一轮完整性优化。
|
||||
|
||||
## 复现方法
|
||||
|
||||
固件端（FilmForge，GD32F405，RS485 115200）：
|
||||
- `M2S500` 开启 500ms 周期温度上报（帧 `B5 F0 04 "25.6" CRC`）；
|
||||
- 连续观察 10 分钟以上，或把上报间隔调到 `M2S100` 加速日志增长。
|
||||
|
||||
预期：修复前时间戳随 UI 卡顿成批挤压、显示延迟随运行时间增大；
|
||||
修复后时间戳单调且间隔≈设定周期，长时间运行无卡顿增长。
|
||||
@@ -0,0 +1,133 @@
|
||||
# SerialMate — RS485/串口调试助手
|
||||
|
||||
> LT8619C 调试工具集配套工具：串口收发 + 协议包解析 + 曲线绘制。
|
||||
> 帧格式（包头/板ID/LEN/CRC）全可定制，默认与 [DLPilot](../DLPilot) 光机
|
||||
> RS485 协议一致，可用来直接调试板载 GD32E230 网关或任意同构协议设备。
|
||||
|
||||
## 功能
|
||||
|
||||
- **串口收发**：端口自动枚举、波特率 1200~921600、数据位/校验/停止位可选，
|
||||
参数热切换；半双工 RS485 友好（每周期最多写一帧，留应答间隙）。
|
||||
- **协议解析**（可关，关=原始透传）：
|
||||
增量字节流定界 + CRC 校验，失败逐字节重同步，噪声自动丢弃；
|
||||
接收帧 ID 位按 DLPilot 语义译码显示（0xF0=成功、0xFD=参数越界…）。
|
||||
- **帧构成定制**（协议卡，发送/接收共用同一布局，仅包头值分方向）：
|
||||
帧构成用**令牌序列**定义，默认 `HDR ID LEN PAYLOAD CRC`（即 DLPilot 五段式）：
|
||||
|
||||
| 令牌 | 含义 |
|
||||
|---|---|
|
||||
| `HDR` | 包头（值取 TX包头 / RX包头 字段） |
|
||||
| `ID` | 板ID（RX 侧多为响应 TYPE 码，不校验仅透出显示） |
|
||||
| `LEN` | 长度字节，口径可选：**payload 长度（默认）** / 到帧尾(payload+CRC) / 整帧 |
|
||||
| `PAYLOAD` | 协议载荷（发送框内容，别名 DATA） |
|
||||
| `CRC` | 校验（算法/覆盖范围见下表，必须在末尾） |
|
||||
| 十六进制字面量 | 固定字节，如 `AA 55` 双字节同步头 |
|
||||
|
||||
示例：`AA 55 LEN PAYLOAD CRC`（AA55 同步头、无板ID）·
|
||||
`HDR LEN PAYLOAD ID CRC`（板ID 在载荷后）· `HDR LEN ID PAYLOAD CRC`（板ID 在长度后）。
|
||||
约束：LEN/PAYLOAD/CRC 恰好各一次，LEN 前至少一个 HDR 或字面量作同步头。
|
||||
|
||||
| 项 | 说明 | 默认 |
|
||||
|---|---|---|
|
||||
| TX 包头 | HDR 令牌在命令帧的值 | `D5` |
|
||||
| RX 包头 | HDR 令牌在响应帧的值 | `B5` |
|
||||
| 板ID | ID 令牌的值（TX 用；RX 侧仅透出） | `01` |
|
||||
| LEN 口径 | payload 长度 / 到帧尾(payload+CRC) / 整帧 | payload 长度 |
|
||||
| CRC 算法 | SUM8 累加和 / CRC8 / CRC16 MODBUS / CRC16 XMODEM / CRC16 CCITT-FALSE | SUM8 |
|
||||
| CRC 覆盖 | 含包头(整帧) / 不含包头(跳过第1字节) / 仅 payload | 不含包头 |
|
||||
- **接收显示**：payload 一键切换 **字符串 / HEX**；可选附原始帧 hex；
|
||||
时间戳为**字节到达时刻**（串口后台线程打点随帧携带，UI 繁忙时日志时间
|
||||
依然可信）；日志保存为 txt。接收日志自动治理：行数上限 5000（超量淘汰
|
||||
最旧）、批量刷新、事件积压时高频帧日志自动折叠为计数摘要（曲线照常
|
||||
采集）——长时间高频运行不累积卡顿。
|
||||
- **曲线**：4 通道，每帧有效数据按通道提取一个数值，支持三种提取方式
|
||||
（二进制定长 u8~f32 大小端 / 文本第 N 个数字 / 自定义正则）+ 倍率，
|
||||
y 轴自动或手动量程，暂停/清空；绘图区可**弹成独立窗口**（"弹出"按钮，
|
||||
关掉窗口即嵌回），通道配置与暂停等控件留在主界面照常控制。弹出窗口内：
|
||||
纵轴每条参考线标注数值刻度；**时间窗**可选宽度（跟随/10s/30s/1min/5min/
|
||||
15min），配合横向滑条回看历史总体趋势或缩小窗口细看局部走势，拉到最右
|
||||
恢复实时跟随（冻结查看请配合"暂停"）；窗口宽度不向数据收敛——数据不足时
|
||||
显示完整的所选时间轴、曲线贴右端随采集逐渐填满（示波器式），右下角标注
|
||||
"已采集 Xs / 窗口 Ns"；**鼠标悬停**在曲线上，绘图区顶部的小读数框持续显示
|
||||
光标处时间点 T 与各通道在该时刻的 Y 轴数值（±10px 容差取最近采样）；
|
||||
弹出窗口工具栏：**暂停渲染**（只冻结画面方便查看，采集继续入库，点"继续
|
||||
渲染"后把积累的数据一次性画出来；画面中央会显示"已冻结渲染"角标；注意
|
||||
与主界面"暂停"的区别：那个会丢弃暂停期间的数据）、**自动Y**（开/关自动
|
||||
纵轴，关闭后可在图上按住左键上下拖动自定义 Y 轴范围）、**实时**（取消
|
||||
滞后跳回最新）、**滚轮**在图上缩放时间窗（2s~15min）。
|
||||
实例：回包 payload `01 AE 75 6D`（前 2 字节固定、第 3~4 字节是 16 位大端
|
||||
采样值 0x7444~0x7696）→ 勾选通道1，方式=二进制，偏移=2，格式=u16 大端，
|
||||
倍率按传感器量纲填（如 0.01）；最新值显示在通道行尾并进入曲线。
|
||||
注意偏移是 payload 内的字节序号（0=第 1 字节），选错位宽/偏移会把多个字段
|
||||
拼成一个数（如 u32@偏移0 会把整包读成 28,210,029）；数值显示为千分位普通
|
||||
小数，≥10 亿才用科学计数。
|
||||
- **板型档案**：不同板子的"协议参数 + 命令预设表"存为命名档案，保存在 exe
|
||||
同目录的 `board_profiles.json`。发送卡选中板型即一键套用其协议参数
|
||||
（包头/板ID/帧构成/LEN口径/CRC）并切换命令预设；**新建板型**按当前协议参数
|
||||
建档、命令预设从空白开始；**存为板型**把当前配置存成档案（同名覆盖）；
|
||||
**删除板型**带确认（至少保留一个）；"存入预设"把当前输入的命令加入当前
|
||||
板型（可自定义显示名称）；**配置**打开表格编辑器（名称/命令两列，+加行
|
||||
−删行，保存写回档案）；预设下拉以"名称 · 命令"同显。
|
||||
- **发送**：
|
||||
- **自动包装**：输入协议载荷（如 `M731S0T1000`）自动组帧加包头/板ID/LEN/CRC；
|
||||
多条用 `/` 分隔依次发送（如 `M1/M731S0T1000`）；
|
||||
- **HEX 直发**：输入完整帧 hex 原样发出；
|
||||
- 周期发送（100ms~60s）、输入框实时组帧预览、预设命令一键填入、
|
||||
命令历史 ↑↓ 回溯、回车即发送。
|
||||
|
||||
## 运行
|
||||
|
||||
- 直接运行 `release/SerialMate.exe`（免安装，Windows 10/11 x64）；
|
||||
- 或源码运行：`py -3 -m pip install PySide6 PySide6-Fluent-Widgets pyserial`，
|
||||
然后 `cd src && python main.py`。
|
||||
|
||||
## 界面速览
|
||||
|
||||
```
|
||||
┌ SerialMate ─────────────────────────────────────────────────┐
|
||||
│ 串口卡 协议卡 │ 接收卡(payload 字符串/HEX) │
|
||||
│ COMx 115200 8N1 D5/B5/01 │ ← 12:00:00 B=0xF0 成功 LEN=2 ok │
|
||||
│ 曲线卡(4通道) │ ┌───────── 滚动曲线 ─────────┐ │
|
||||
│ ☑ DMD温度 文本数字 第1个 ×0.1 │ └────────────────────────────┘ │
|
||||
│ │ 发送卡: [M1/M731S0T1000] 发送 │
|
||||
└────────────────────────────────┴──────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 典型用法：调光机 RS485
|
||||
|
||||
1. 串口卡选 USB-RS485 适配器，115200 8N1，连接；
|
||||
2. 发送框输入 `M1` 回车——自动包装为 `D5 01 02 4D 31 81` 发出，
|
||||
接收区回 `ok`（协议卡默认即 DLPilot 协议）；
|
||||
3. 查温度：发 `M201`，回包 `okTL:246` 译码显示"成功"，曲线卡勾选通道
|
||||
设为"文本数字·第1个·×0.1"，周期发送勾上，即可看温度曲线；
|
||||
4. 换任何自定义协议：改协议卡的**帧构成**（字段顺序/有无板ID/字面量同步头）、
|
||||
包头/板ID/LEN 口径/CRC 即可，收发解析同步生效；调好后点"存为板型"，
|
||||
以后一键切换。
|
||||
|
||||
## 目录
|
||||
|
||||
```
|
||||
SerialMate/
|
||||
├── src/ 源代码（protocol 协议 / link 串口线程 / main GUI / selftest 自检）
|
||||
├── assets/ serial-mate.ico 图标（assets/make_icon.py 生成）
|
||||
├── release/ SerialMate.exe + README（发布文件夹，zip 只上传 Release）
|
||||
└── README.md 本文
|
||||
```
|
||||
|
||||
运行时用户数据与 exe 同目录平铺：`serial_mate.json`（串口/协议/通道记忆）、
|
||||
`board_profiles.json`（板型档案，首次运行自动生成默认"DLPilot光机"）。
|
||||
|
||||
## 开发 / 发布
|
||||
|
||||
```powershell
|
||||
cd src
|
||||
python selftest.py # 协议回归(无依赖, 改 protocol.py 后必跑)
|
||||
python selftest_loop.py # 链路回环自检(loop:// 虚拟口, 需 pyserial)
|
||||
python main.py # 源码运行
|
||||
python build_exe.py # → ../release/SerialMate.exe
|
||||
python package_release.py <版本> # → release/SerialMate-v<版本>-win64.zip
|
||||
python publish_gitea.py ../release/SerialMate-v<版本>-win64.zip --replace --insecure
|
||||
```
|
||||
|
||||
工程约束与进度见 [AGENTS.md](AGENTS.md)；协议语义唯一权威是上游固件仓
|
||||
`protocols.md`（本仓 DLPilot 目录有引用说明）。
|
||||
@@ -0,0 +1,62 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
SerialMate 图标栅格化(家族风格, 与 DLPilot/EDID-Viewer/FlashTool 同版式):
|
||||
黑底 512, 绿色圆角矩形, 第一行 Serial(框内黑字), 第二行 Mate(白字)
|
||||
================================================================
|
||||
设计参数: 黑底 512, 绿色圆角矩形 x38 y64 w436 h186 rx34 (#00C878, 与
|
||||
gd32e230f8_firmware_merge_tool 的 FlashTool 同色系), Arial Bold。
|
||||
Serial 6 字母按框宽自适应字号(上限 146px, 留边距),
|
||||
Mate 146px 白字(基线对齐同 DLPilot 的 Pilot)。
|
||||
|
||||
用法: python make_icon.py # 生成 serial-mate.png / serial-mate.ico
|
||||
"""
|
||||
|
||||
import os
|
||||
|
||||
from PIL import Image, ImageDraw, ImageFont
|
||||
|
||||
BASE = os.path.dirname(os.path.abspath(__file__))
|
||||
FONT = r'C:\Windows\Fonts\arialbd.ttf' # Arial Bold, Windows 标配
|
||||
|
||||
|
||||
def fit_font(draw, text, max_w, start):
|
||||
"""从 start 字号往下找能装入 max_w 宽的字号(步进 2)"""
|
||||
size = start
|
||||
while size > 8:
|
||||
f = ImageFont.truetype(FONT, size)
|
||||
box = draw.textbbox((0, 0), text, font=f)
|
||||
if box[2] - box[0] <= max_w:
|
||||
return f
|
||||
size -= 2
|
||||
return ImageFont.truetype(FONT, 8)
|
||||
|
||||
|
||||
def render(size=512):
|
||||
s = size / 512.0
|
||||
img = Image.new('RGB', (size, size), (0, 0, 0))
|
||||
d = ImageDraw.Draw(img)
|
||||
d.rounded_rectangle([38 * s, 64 * s, (38 + 436) * s, (64 + 186) * s],
|
||||
radius=34 * s, fill=(0, 200, 120))
|
||||
if not os.path.exists(FONT):
|
||||
raise SystemExit(f'未找到字体 {FONT}, 无法栅格化')
|
||||
# Serial: 黑字居中于橙色框, 按框宽自适应(留 2×18px 边距)
|
||||
f1 = fit_font(d, 'Serial', 400 * s, round(146 * s))
|
||||
d.text((size / 2, 64 * s + 186 * s / 2), 'Serial', font=f1,
|
||||
fill=(0, 0, 0), anchor='mm')
|
||||
# Mate: 白字, 与家族一致 146px(无下伸字母, 中心 = 基线421 - cap/2 ~= 368)
|
||||
f2 = ImageFont.truetype(FONT, max(8, round(146 * s)))
|
||||
d.text((size / 2, 368 * s), 'Mate', font=f2, fill=(255, 255, 255),
|
||||
anchor='mm')
|
||||
return img
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
img = render(512)
|
||||
png = os.path.join(BASE, 'serial-mate.png')
|
||||
ico = os.path.join(BASE, 'serial-mate.ico')
|
||||
img.save(png)
|
||||
img.save(ico, sizes=[(16, 16), (24, 24), (32, 32), (48, 48),
|
||||
(64, 64), (128, 128), (256, 256)])
|
||||
print(f'写出 {png}')
|
||||
print(f'写出 {ico}')
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 30 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 16 KiB |
@@ -0,0 +1,133 @@
|
||||
# SerialMate — RS485/串口调试助手
|
||||
|
||||
> LT8619C 调试工具集配套工具：串口收发 + 协议包解析 + 曲线绘制。
|
||||
> 帧格式（包头/板ID/LEN/CRC）全可定制，默认与 [DLPilot](../DLPilot) 光机
|
||||
> RS485 协议一致，可用来直接调试板载 GD32E230 网关或任意同构协议设备。
|
||||
|
||||
## 功能
|
||||
|
||||
- **串口收发**：端口自动枚举、波特率 1200~921600、数据位/校验/停止位可选，
|
||||
参数热切换；半双工 RS485 友好（每周期最多写一帧，留应答间隙）。
|
||||
- **协议解析**（可关，关=原始透传）：
|
||||
增量字节流定界 + CRC 校验，失败逐字节重同步，噪声自动丢弃；
|
||||
接收帧 ID 位按 DLPilot 语义译码显示（0xF0=成功、0xFD=参数越界…）。
|
||||
- **帧构成定制**（协议卡，发送/接收共用同一布局，仅包头值分方向）：
|
||||
帧构成用**令牌序列**定义，默认 `HDR ID LEN PAYLOAD CRC`（即 DLPilot 五段式）：
|
||||
|
||||
| 令牌 | 含义 |
|
||||
|---|---|
|
||||
| `HDR` | 包头（值取 TX包头 / RX包头 字段） |
|
||||
| `ID` | 板ID（RX 侧多为响应 TYPE 码，不校验仅透出显示） |
|
||||
| `LEN` | 长度字节，口径可选：**payload 长度（默认）** / 到帧尾(payload+CRC) / 整帧 |
|
||||
| `PAYLOAD` | 协议载荷（发送框内容，别名 DATA） |
|
||||
| `CRC` | 校验（算法/覆盖范围见下表，必须在末尾） |
|
||||
| 十六进制字面量 | 固定字节，如 `AA 55` 双字节同步头 |
|
||||
|
||||
示例：`AA 55 LEN PAYLOAD CRC`（AA55 同步头、无板ID）·
|
||||
`HDR LEN PAYLOAD ID CRC`（板ID 在载荷后）· `HDR LEN ID PAYLOAD CRC`（板ID 在长度后）。
|
||||
约束：LEN/PAYLOAD/CRC 恰好各一次，LEN 前至少一个 HDR 或字面量作同步头。
|
||||
|
||||
| 项 | 说明 | 默认 |
|
||||
|---|---|---|
|
||||
| TX 包头 | HDR 令牌在命令帧的值 | `D5` |
|
||||
| RX 包头 | HDR 令牌在响应帧的值 | `B5` |
|
||||
| 板ID | ID 令牌的值（TX 用；RX 侧仅透出） | `01` |
|
||||
| LEN 口径 | payload 长度 / 到帧尾(payload+CRC) / 整帧 | payload 长度 |
|
||||
| CRC 算法 | SUM8 累加和 / CRC8 / CRC16 MODBUS / CRC16 XMODEM / CRC16 CCITT-FALSE | SUM8 |
|
||||
| CRC 覆盖 | 含包头(整帧) / 不含包头(跳过第1字节) / 仅 payload | 不含包头 |
|
||||
- **接收显示**：payload 一键切换 **字符串 / HEX**；可选附原始帧 hex；
|
||||
时间戳为**字节到达时刻**（串口后台线程打点随帧携带，UI 繁忙时日志时间
|
||||
依然可信）；日志保存为 txt。接收日志自动治理：行数上限 5000（超量淘汰
|
||||
最旧）、批量刷新、事件积压时高频帧日志自动折叠为计数摘要（曲线照常
|
||||
采集）——长时间高频运行不累积卡顿。
|
||||
- **曲线**：4 通道，每帧有效数据按通道提取一个数值，支持三种提取方式
|
||||
（二进制定长 u8~f32 大小端 / 文本第 N 个数字 / 自定义正则）+ 倍率，
|
||||
y 轴自动或手动量程，暂停/清空；绘图区可**弹成独立窗口**（"弹出"按钮，
|
||||
关掉窗口即嵌回），通道配置与暂停等控件留在主界面照常控制。弹出窗口内：
|
||||
纵轴每条参考线标注数值刻度；**时间窗**可选宽度（跟随/10s/30s/1min/5min/
|
||||
15min），配合横向滑条回看历史总体趋势或缩小窗口细看局部走势，拉到最右
|
||||
恢复实时跟随（冻结查看请配合"暂停"）；窗口宽度不向数据收敛——数据不足时
|
||||
显示完整的所选时间轴、曲线贴右端随采集逐渐填满（示波器式），右下角标注
|
||||
"已采集 Xs / 窗口 Ns"；**鼠标悬停**在曲线上，绘图区顶部的小读数框持续显示
|
||||
光标处时间点 T 与各通道在该时刻的 Y 轴数值（±10px 容差取最近采样）；
|
||||
弹出窗口工具栏：**暂停渲染**（只冻结画面方便查看，采集继续入库，点"继续
|
||||
渲染"后把积累的数据一次性画出来；画面中央会显示"已冻结渲染"角标；注意
|
||||
与主界面"暂停"的区别：那个会丢弃暂停期间的数据）、**自动Y**（开/关自动
|
||||
纵轴，关闭后可在图上按住左键上下拖动自定义 Y 轴范围）、**实时**（取消
|
||||
滞后跳回最新）、**滚轮**在图上缩放时间窗（2s~15min）。
|
||||
实例：回包 payload `01 AE 75 6D`（前 2 字节固定、第 3~4 字节是 16 位大端
|
||||
采样值 0x7444~0x7696）→ 勾选通道1，方式=二进制，偏移=2，格式=u16 大端，
|
||||
倍率按传感器量纲填（如 0.01）；最新值显示在通道行尾并进入曲线。
|
||||
注意偏移是 payload 内的字节序号（0=第 1 字节），选错位宽/偏移会把多个字段
|
||||
拼成一个数（如 u32@偏移0 会把整包读成 28,210,029）；数值显示为千分位普通
|
||||
小数，≥10 亿才用科学计数。
|
||||
- **板型档案**：不同板子的"协议参数 + 命令预设表"存为命名档案，保存在 exe
|
||||
同目录的 `board_profiles.json`。发送卡选中板型即一键套用其协议参数
|
||||
（包头/板ID/帧构成/LEN口径/CRC）并切换命令预设；**新建板型**按当前协议参数
|
||||
建档、命令预设从空白开始；**存为板型**把当前配置存成档案（同名覆盖）；
|
||||
**删除板型**带确认（至少保留一个）；"存入预设"把当前输入的命令加入当前
|
||||
板型（可自定义显示名称）；**配置**打开表格编辑器（名称/命令两列，+加行
|
||||
−删行，保存写回档案）；预设下拉以"名称 · 命令"同显。
|
||||
- **发送**：
|
||||
- **自动包装**：输入协议载荷（如 `M731S0T1000`）自动组帧加包头/板ID/LEN/CRC；
|
||||
多条用 `/` 分隔依次发送（如 `M1/M731S0T1000`）；
|
||||
- **HEX 直发**：输入完整帧 hex 原样发出；
|
||||
- 周期发送（100ms~60s）、输入框实时组帧预览、预设命令一键填入、
|
||||
命令历史 ↑↓ 回溯、回车即发送。
|
||||
|
||||
## 运行
|
||||
|
||||
- 直接运行 `release/SerialMate.exe`（免安装，Windows 10/11 x64）；
|
||||
- 或源码运行：`py -3 -m pip install PySide6 PySide6-Fluent-Widgets pyserial`，
|
||||
然后 `cd src && python main.py`。
|
||||
|
||||
## 界面速览
|
||||
|
||||
```
|
||||
┌ SerialMate ─────────────────────────────────────────────────┐
|
||||
│ 串口卡 协议卡 │ 接收卡(payload 字符串/HEX) │
|
||||
│ COMx 115200 8N1 D5/B5/01 │ ← 12:00:00 B=0xF0 成功 LEN=2 ok │
|
||||
│ 曲线卡(4通道) │ ┌───────── 滚动曲线 ─────────┐ │
|
||||
│ ☑ DMD温度 文本数字 第1个 ×0.1 │ └────────────────────────────┘ │
|
||||
│ │ 发送卡: [M1/M731S0T1000] 发送 │
|
||||
└────────────────────────────────┴──────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 典型用法：调光机 RS485
|
||||
|
||||
1. 串口卡选 USB-RS485 适配器，115200 8N1，连接；
|
||||
2. 发送框输入 `M1` 回车——自动包装为 `D5 01 02 4D 31 81` 发出，
|
||||
接收区回 `ok`（协议卡默认即 DLPilot 协议）；
|
||||
3. 查温度：发 `M201`，回包 `okTL:246` 译码显示"成功"，曲线卡勾选通道
|
||||
设为"文本数字·第1个·×0.1"，周期发送勾上，即可看温度曲线；
|
||||
4. 换任何自定义协议：改协议卡的**帧构成**（字段顺序/有无板ID/字面量同步头）、
|
||||
包头/板ID/LEN 口径/CRC 即可，收发解析同步生效；调好后点"存为板型"，
|
||||
以后一键切换。
|
||||
|
||||
## 目录
|
||||
|
||||
```
|
||||
SerialMate/
|
||||
├── src/ 源代码（protocol 协议 / link 串口线程 / main GUI / selftest 自检）
|
||||
├── assets/ serial-mate.ico 图标（assets/make_icon.py 生成）
|
||||
├── release/ SerialMate.exe + README（发布文件夹，zip 只上传 Release）
|
||||
└── README.md 本文
|
||||
```
|
||||
|
||||
运行时用户数据与 exe 同目录平铺：`serial_mate.json`（串口/协议/通道记忆）、
|
||||
`board_profiles.json`（板型档案，首次运行自动生成默认"DLPilot光机"）。
|
||||
|
||||
## 开发 / 发布
|
||||
|
||||
```powershell
|
||||
cd src
|
||||
python selftest.py # 协议回归(无依赖, 改 protocol.py 后必跑)
|
||||
python selftest_loop.py # 链路回环自检(loop:// 虚拟口, 需 pyserial)
|
||||
python main.py # 源码运行
|
||||
python build_exe.py # → ../release/SerialMate.exe
|
||||
python package_release.py <版本> # → release/SerialMate-v<版本>-win64.zip
|
||||
python publish_gitea.py ../release/SerialMate-v<版本>-win64.zip --replace --insecure
|
||||
```
|
||||
|
||||
工程约束与进度见 [AGENTS.md](AGENTS.md)；协议语义唯一权威是上游固件仓
|
||||
`protocols.md`（本仓 DLPilot 目录有引用说明）。
|
||||
@@ -0,0 +1,49 @@
|
||||
"""模拟真机 M2S100 场景: 设备 100ms 周期上报 30 帧, 验证帧按帧粒度
|
||||
到达 GUI 回调(间隔≈100ms, 到达→消费延迟<300ms), 而非攒批后一次涌入。
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
import time
|
||||
import threading
|
||||
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
from link import SerialLink
|
||||
import protocol as d
|
||||
|
||||
got = []
|
||||
cfg = d.ProtoConfig()
|
||||
link = SerialLink(cfg, on_status=lambda s, ts: None)
|
||||
link.on_frame = lambda fr, ts: got.append((time.time(), ts))
|
||||
|
||||
link.open('loop://', 115200)
|
||||
deadline = time.time() + 5
|
||||
while time.time() < deadline and not link.is_connected():
|
||||
time.sleep(0.05)
|
||||
assert link.is_connected(), 'loop:// 未连接'
|
||||
|
||||
resp = bytes.fromhex('B5 F0 08 6F 6B 54 4C 3A 32 34 36 48')
|
||||
|
||||
def feeder():
|
||||
for _ in range(30):
|
||||
link.ser.write(resp)
|
||||
time.sleep(0.1)
|
||||
|
||||
t = threading.Thread(target=feeder)
|
||||
t.start()
|
||||
t.join()
|
||||
time.sleep(0.5) # 等最后一帧走完读线程
|
||||
|
||||
n = len(got)
|
||||
print('收到帧数:', n, '(期望 30)')
|
||||
if n >= 2:
|
||||
gaps = [b[0] - a[0] for a, b in zip(got, got[1:])]
|
||||
lag = [cb - ts for cb, ts in got]
|
||||
print('回调间隔 min/max/avg(ms): %d / %d / %d'
|
||||
% (min(gaps) * 1000, max(gaps) * 1000, sum(gaps) / len(gaps) * 1000))
|
||||
print('到达→消费延迟 max(ms):', round(max(lag) * 1000))
|
||||
ok = n == 30 and max(gaps) < 0.5 and max(lag) < 0.3
|
||||
else:
|
||||
ok = False
|
||||
print('RESULT:', 'PASS' if ok else 'FAIL')
|
||||
link.close()
|
||||
sys.exit(0 if ok else 1)
|
||||
@@ -0,0 +1,108 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
把 src/main.py 打包成单文件 exe(工具名: SerialMate)
|
||||
================================================
|
||||
与 EDID-Viewer/src/build_exe.py 同一套路: onefile + --noconsole, Python 解释器、
|
||||
PySide6 和 PySide6-Fluent-Widgets 全部打进一个 exe, 目标机器无需安装依赖。
|
||||
|
||||
用法:
|
||||
python build_exe.py 自动安装 PyInstaller(如缺)并打包
|
||||
python build_exe.py --debug 额外打一个带控制台的变体
|
||||
|
||||
产物: release/SerialMate.exe
|
||||
spec 由本脚本生成到 src/build/(不入库), 调整打包逻辑直接改这里的模板。
|
||||
"""
|
||||
import os
|
||||
import subprocess
|
||||
import sys
|
||||
|
||||
# 本脚本位于 src/, 打包产物输出到工具根的 release/
|
||||
SRC = os.path.dirname(os.path.abspath(__file__))
|
||||
BASE = os.path.dirname(SRC)
|
||||
RELEASE = os.path.join(BASE, 'release')
|
||||
WORK = os.path.join(SRC, 'build')
|
||||
ICO = os.path.join(BASE, 'assets', 'serial-mate.ico')
|
||||
|
||||
SPEC_TEMPLATE = """\
|
||||
# -*- coding: utf-8 -*-
|
||||
# 由 build_exe.py 生成, 不要手改; 调整打包逻辑请改 src/build_exe.py。
|
||||
from PyInstaller.utils.hooks import collect_all
|
||||
|
||||
qfluent_datas, qfluent_binaries, qfluent_hidden = collect_all('qfluentwidgets')
|
||||
a = Analysis(
|
||||
[r'{entry}'], pathex=[r'{src}'], binaries=qfluent_binaries,
|
||||
datas=qfluent_datas + {icon_datas}, hiddenimports=qfluent_hidden,
|
||||
noarchive=False)
|
||||
# Qt 6.11 使用 Windows 非版本化 ICU 导出; PATH 上 Poppler/Conda 的版本化
|
||||
# ICU(icuuc.dll/icudt78.dll)会被 PyInstaller 误收, 令 QtCore.pyd 启动报
|
||||
# WinError 127 —— 打包时剔除, 运行时用系统自带 ICU。
|
||||
a.binaries = [b for b in a.binaries if b[0].lower() not in ('icuuc.dll', 'icudt78.dll')]
|
||||
pyz = PYZ(a.pure)
|
||||
exe = EXE(pyz, a.scripts, a.binaries, a.datas, [], name='{name}',
|
||||
debug=False, strip=False, upx=False, console={console}{icon_clause})
|
||||
"""
|
||||
|
||||
|
||||
def ensure_pyinstaller():
|
||||
try:
|
||||
import PyInstaller # noqa: F401
|
||||
return
|
||||
except ImportError:
|
||||
pass
|
||||
print('PyInstaller 未安装, 正在安装...')
|
||||
subprocess.check_call([sys.executable, '-m', 'pip', 'install', 'pyinstaller'])
|
||||
|
||||
|
||||
def remove_stale(exe_path):
|
||||
"""删除旧 exe; 若被占用(上次验证的进程还在), 先结束同名进程再重试"""
|
||||
if not os.path.exists(exe_path):
|
||||
return
|
||||
try:
|
||||
os.remove(exe_path)
|
||||
return
|
||||
except PermissionError:
|
||||
pass
|
||||
import time
|
||||
print(f'{exe_path} 被占用, 结束残留进程后重试...')
|
||||
subprocess.run(['taskkill', '/F', '/IM', os.path.basename(exe_path)],
|
||||
capture_output=True)
|
||||
time.sleep(1.0)
|
||||
os.remove(exe_path)
|
||||
|
||||
|
||||
def build(name, console):
|
||||
remove_stale(os.path.join(RELEASE, name + '.exe'))
|
||||
if os.path.exists(ICO):
|
||||
icon_datas = f"[(r'{ICO}', 'assets')]"
|
||||
icon_clause = f", icon=r'{ICO}'"
|
||||
else:
|
||||
print('警告: 未找到 assets/serial-mate.ico, 本次打包不带图标')
|
||||
icon_datas, icon_clause = '[]', ''
|
||||
spec = SPEC_TEMPLATE.format(entry=os.path.join(SRC, 'main.py'), src=SRC,
|
||||
icon_datas=icon_datas, name=name,
|
||||
console=console, icon_clause=icon_clause)
|
||||
os.makedirs(WORK, exist_ok=True)
|
||||
spec_path = os.path.join(WORK, name + '.spec')
|
||||
with open(spec_path, 'w', encoding='utf-8') as f:
|
||||
f.write(spec)
|
||||
cmd = [sys.executable, '-m', 'PyInstaller', '--noconfirm', '--clean',
|
||||
'--distpath', RELEASE, '--workpath', WORK, spec_path]
|
||||
print('\n>>', ' '.join(cmd))
|
||||
subprocess.check_call(cmd)
|
||||
out = os.path.join(RELEASE, name + '.exe')
|
||||
print(f'完成: {out} ({os.path.getsize(out) / 1024 / 1024:.1f} MB)')
|
||||
|
||||
|
||||
def main():
|
||||
build_console = '--debug' in sys.argv
|
||||
ensure_pyinstaller()
|
||||
# 常规版: 双击即用, 无黑框
|
||||
build('SerialMate', 'False')
|
||||
if build_console:
|
||||
# 调试版: 带控制台, 异常栈可见
|
||||
build('SerialMate-console', 'True')
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
@@ -0,0 +1,147 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
运行目录定位与设置持久化(BASE_DIR 语义与 DLPilot config.py 一致)
|
||||
==================================================================
|
||||
frozen(PyInstaller onefile)时 BASE_DIR=exe 所在目录(sys.executable),
|
||||
源码运行时=config.py 所在目录(即 src/)。设置写/读自 BASE_DIR 平铺的
|
||||
serial_mate.json, 不建子目录。
|
||||
|
||||
读容错: 文件缺失/损坏/缺键一律回落默认值, 并保证返回的 dict 键全齐,
|
||||
GUI 无需判空。
|
||||
"""
|
||||
|
||||
import json
|
||||
import os
|
||||
import shutil
|
||||
import sys
|
||||
|
||||
if getattr(sys, 'frozen', False):
|
||||
BASE_DIR = os.path.dirname(os.path.abspath(sys.executable))
|
||||
else:
|
||||
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
|
||||
|
||||
CONFIG_FILE = os.path.join(BASE_DIR, 'serial_mate.json')
|
||||
LEGACY_CONFIG = os.path.join(BASE_DIR, 'serial_assistant.json') # 更名前的配置
|
||||
PROFILES_FILE = os.path.join(BASE_DIR, 'board_profiles.json')
|
||||
|
||||
|
||||
def _migrate_legacy_config():
|
||||
"""SerialAssistant -> SerialMate 更名迁移: 旧配置搬为新名(一次性, 已存在则跳过)"""
|
||||
if os.path.exists(CONFIG_FILE) or not os.path.exists(LEGACY_CONFIG):
|
||||
return
|
||||
try:
|
||||
shutil.copy2(LEGACY_CONFIG, CONFIG_FILE)
|
||||
except OSError:
|
||||
pass
|
||||
|
||||
DEFAULTS = {
|
||||
'serial': {'port': '', 'baud': 115200, 'bytesize': 8, 'parity': 'N', 'stopbits': 1},
|
||||
'proto': {'tx_hdr': 'D5', 'rx_hdr': 'B5', 'board': '01',
|
||||
'crc_algo': 'SUM8', 'crc_scope': 'no_header', 'parse': True,
|
||||
'layout': 'HDR ID LEN PAYLOAD CRC', 'len_sem': 'payload'},
|
||||
'tx': {'mode': 'wrap', 'periodic': False, 'interval_ms': 1000, 'profile': ''},
|
||||
'rx': {'display': 'text', 'show_raw': True},
|
||||
'channels': [
|
||||
{'enabled': False, 'name': '通道1', 'mode': 'num', 'offset': 0,
|
||||
'fmt': 'u16be', 'index': 1, 'pattern': '(?<=:)\\d+', 'scale': 1.0},
|
||||
{'enabled': False, 'name': '通道2', 'mode': 'bin', 'offset': 0,
|
||||
'fmt': 's16be', 'index': 1, 'pattern': '(?<=:)\\d+', 'scale': 1.0},
|
||||
{'enabled': False, 'name': '通道3', 'mode': 'bin', 'offset': 0,
|
||||
'fmt': 'u16be', 'index': 1, 'pattern': '(?<=:)\\d+', 'scale': 1.0},
|
||||
{'enabled': False, 'name': '通道4', 'mode': 'bin', 'offset': 0,
|
||||
'fmt': 'u16be', 'index': 1, 'pattern': '(?<=:)\\d+', 'scale': 1.0},
|
||||
],
|
||||
}
|
||||
|
||||
# 板型档案的帧协议字段(不含 parse —— 解析开关是查看偏好, 不随板型走)
|
||||
_PROFILE_PROTO_KEYS = ('tx_hdr', 'rx_hdr', 'board', 'layout', 'len_sem',
|
||||
'crc_algo', 'crc_scope')
|
||||
|
||||
# 首个板型的命令预设(DLPilot 光机命令集, 全表见上游 protocols.md)
|
||||
DEFAULT_COMMANDS = (
|
||||
('握手', 'M1'), ('查版本', 'M999'),
|
||||
('开光机', 'M730S0'), ('关光机', 'M730S1'),
|
||||
('设光强', 'M731S100'), ('查电流', 'M732'),
|
||||
('查DMD温度', 'M201'), ('查LAMP温度', 'M202'),
|
||||
('TEC自动控温开', 'M7S0'), ('TEC自动控温关', 'M7S1'),
|
||||
('凝露点33.0°C', 'M8S330'), ('软件重启', 'M888'),
|
||||
)
|
||||
|
||||
|
||||
def default_profiles():
|
||||
"""首个板型档案: DLPilot 光机(协议字段取默认值)"""
|
||||
return [{'name': 'DLPilot光机',
|
||||
'proto': {k: DEFAULTS['proto'][k] for k in _PROFILE_PROTO_KEYS},
|
||||
'commands': [list(c) for c in DEFAULT_COMMANDS]}]
|
||||
|
||||
|
||||
def _merge(base, over):
|
||||
"""递归覆盖: over 缺键用 base 补齐, over 多余键保留(向前兼容旧配置)"""
|
||||
out = dict(base)
|
||||
for k, v in over.items():
|
||||
if k in base and isinstance(base[k], dict) and isinstance(v, dict):
|
||||
out[k] = _merge(base[k], v)
|
||||
else:
|
||||
out[k] = v
|
||||
return out
|
||||
|
||||
|
||||
def load():
|
||||
_migrate_legacy_config()
|
||||
"""读设置; 任何异常回落默认(键全齐), 不抛出"""
|
||||
try:
|
||||
with open(CONFIG_FILE, encoding='utf-8') as f:
|
||||
data = json.load(f)
|
||||
if not isinstance(data, dict):
|
||||
raise ValueError('配置根不是对象')
|
||||
except Exception:
|
||||
return json.loads(json.dumps(DEFAULTS)) # 深拷贝默认值
|
||||
return _merge(DEFAULTS, data)
|
||||
|
||||
|
||||
def save(cfg):
|
||||
"""写设置; 失败静默(只读目录等场景不阻塞退出)"""
|
||||
try:
|
||||
with open(CONFIG_FILE, 'w', encoding='utf-8') as f:
|
||||
json.dump(cfg, f, ensure_ascii=False, indent=1)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
|
||||
def load_profiles():
|
||||
"""读板型档案(board_profiles.json); 缺失/损坏回落默认并落盘。
|
||||
档案结构: {'profiles': [{'name', 'proto'{7字段}, 'commands'[[名,命令]..]}..]}"""
|
||||
try:
|
||||
with open(PROFILES_FILE, encoding='utf-8') as f:
|
||||
data = json.load(f)
|
||||
profiles = data.get('profiles') if isinstance(data, dict) else data
|
||||
if isinstance(profiles, list) and profiles:
|
||||
out = []
|
||||
for p in profiles:
|
||||
if not isinstance(p, dict) or not p.get('name'):
|
||||
continue
|
||||
out.append({'name': str(p['name']),
|
||||
'proto': {k: p.get('proto', {}).get(k,
|
||||
DEFAULTS['proto'][k])
|
||||
for k in _PROFILE_PROTO_KEYS},
|
||||
'commands': [[str(n), str(c)]
|
||||
for n, c in p.get('commands', [])
|
||||
if isinstance(n, str) and isinstance(c, str)]})
|
||||
if out:
|
||||
return out
|
||||
except Exception:
|
||||
pass
|
||||
profiles = default_profiles()
|
||||
save_profiles(profiles)
|
||||
return profiles
|
||||
|
||||
|
||||
def save_profiles(profiles):
|
||||
"""写板型档案; 失败静默并返回 False"""
|
||||
try:
|
||||
with open(PROFILES_FILE, 'w', encoding='utf-8') as f:
|
||||
json.dump({'profiles': profiles}, f, ensure_ascii=False, indent=1)
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
@@ -0,0 +1,226 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
串口链路线程: 端口/波特率热切换 + 发送队列 + 接收分发
|
||||
======================================================
|
||||
与 DLPilot 的 DLPC485 同一套路(D I2C-Inject Injector 同源), 差异点:
|
||||
- 帧格式参数(ProtoConfig)可运行中热替换, 解析器配置随之切换并清残余半帧;
|
||||
- 支持协议解析(Frame 回调)与透传(原始 bytes 回调)两种接收模式, 运行中切换;
|
||||
- 发送一律传完整帧 bytes(组帧由 GUI 侧按 ProtoConfig 完成, 本模块不关心格式)。
|
||||
|
||||
回调全在后台线程触发, GUI 侧必须自行投递回主线程(见 main.py 的轮询队列)。
|
||||
pyserial 为本模块独占依赖(缺失只影响串口功能)。
|
||||
"""
|
||||
|
||||
import collections
|
||||
import queue
|
||||
import re
|
||||
import threading
|
||||
import time
|
||||
|
||||
try:
|
||||
import serial
|
||||
import serial.tools.list_ports
|
||||
HAS_SERIAL = True
|
||||
except ImportError:
|
||||
HAS_SERIAL = False
|
||||
|
||||
DEFAULT_BAUD = 115200
|
||||
DEFAULTS = dict(bytesize=8, parity='N', stopbits=1)
|
||||
|
||||
|
||||
class SerialLink:
|
||||
"""串口工作线程。回调(后台线程触发, 第二参数 ts=事件发生的 epoch 秒):
|
||||
on_status(text, ts) 连接状态变化(已连接/断开/失败/设备拔出)
|
||||
on_frame(fr, ts) 解析模式: 完整 Frame(protocol.Frame); ts=本批字节到达时刻
|
||||
on_raw(data, ts) 透传模式: 原始接收 bytes; ts=到达时刻
|
||||
on_tx(label, data, ts) 发送回显: label=payload 字符串(自动包装)/None(HEX直发);
|
||||
ts=写入串口时刻
|
||||
时间戳必须由本模块在读线程打(字节到达时刻), GUI 消费侧再打会随 UI 卡顿
|
||||
成批挤压失真——日志时间就不再是到达时间。
|
||||
"""
|
||||
|
||||
def __init__(self, cfg, on_status):
|
||||
self.on_status = on_status
|
||||
self.on_frame = None
|
||||
self.on_raw = None
|
||||
self.on_tx = None
|
||||
self.q = queue.Queue()
|
||||
self._cfg = cfg
|
||||
self._parse = True
|
||||
self._target = None # 意图 (port, baud, bytesize, parity, stopbits)
|
||||
self._open_key = None # 当前已打开串口的参数元组
|
||||
self.ser = None
|
||||
self.parser = None # 惰性建: 协议模块无 pyserial 依赖, 此处才用到
|
||||
self._lock = threading.Lock()
|
||||
threading.Thread(target=self._run, daemon=True).start()
|
||||
|
||||
# --- 配置与模式(线程安全) ---
|
||||
|
||||
def set_config(self, cfg):
|
||||
"""热替换帧格式; 解析器半帧缓冲随之清空, 避免新旧格式混接"""
|
||||
with self._lock:
|
||||
self._cfg = cfg
|
||||
if self.parser is not None:
|
||||
self.parser.cfg = cfg
|
||||
self.parser.clear()
|
||||
|
||||
def set_parse(self, enabled):
|
||||
"""切换 解析协议帧 / 原始透传; 切换时清解析缓冲"""
|
||||
with self._lock:
|
||||
self._parse = bool(enabled)
|
||||
if self.parser is not None:
|
||||
self.parser.clear()
|
||||
|
||||
# --- 串口管理 ---
|
||||
|
||||
@staticmethod
|
||||
def list_ports_info():
|
||||
"""枚举串口, 返回 [(设备名, 显示标签), ...]。
|
||||
|
||||
标签 = "COMx 设备描述"(描述里的 "(COMx)" 尾巴去掉), CH344 这类多路
|
||||
适配器每一路描述不同(serial-A/B/C/D), 依此区分; 多口描述完全相同时
|
||||
追加物理位置/序列号消歧。
|
||||
"""
|
||||
if not HAS_SERIAL:
|
||||
return []
|
||||
items = []
|
||||
for p in serial.tools.list_ports.comports():
|
||||
desc = re.sub(r'\s*\((COM\d+)\)\s*$', '', (p.description or '').strip(),
|
||||
flags=re.I)
|
||||
if desc.upper() == p.device.upper():
|
||||
desc = ''
|
||||
label = f'{p.device} {desc}'.rstrip()
|
||||
tail = p.location or p.serial_number or ''
|
||||
items.append((p.device, label, tail))
|
||||
counts = collections.Counter(label for _d, label, _t in items)
|
||||
out = []
|
||||
for dev, label, tail in items:
|
||||
if counts[label] > 1 and tail:
|
||||
label = f'{label} [{tail}]'
|
||||
out.append((dev, label))
|
||||
return out
|
||||
|
||||
def open(self, port, baud=DEFAULT_BAUD, **kw):
|
||||
if not HAS_SERIAL:
|
||||
self.on_status('未安装 pyserial: py -m pip install pyserial', time.time())
|
||||
return
|
||||
params = {**DEFAULTS, **kw}
|
||||
with self._lock:
|
||||
self._target = (port, int(baud), int(params['bytesize']),
|
||||
str(params['parity']).upper(), int(params['stopbits']))
|
||||
|
||||
def close(self):
|
||||
with self._lock:
|
||||
self._target = None
|
||||
|
||||
def is_connected(self):
|
||||
with self._lock:
|
||||
return self.ser is not None
|
||||
|
||||
# --- 发送(队列化, 后台线程写串口) ---
|
||||
|
||||
def send_frame(self, frame, label=''):
|
||||
"""发送一个完整帧 bytes; label 用于回显(自动包装时为 payload 文本)。
|
||||
未连接时直接丢弃并提示(防积压到重连后一起发出, DLPilot 同策略)"""
|
||||
with self._lock:
|
||||
ser = self.ser
|
||||
if ser is None:
|
||||
self.on_status('未连接串口, 命令被丢弃', time.time())
|
||||
return False
|
||||
self.q.put((label, bytes(frame)))
|
||||
return True
|
||||
|
||||
# --- 工作线程 ---
|
||||
|
||||
def _run(self):
|
||||
bytesizes = {8: serial.EIGHTBITS, 7: serial.SEVENBITS,
|
||||
6: serial.SIXBITS, 5: serial.FIVEBITS}
|
||||
parities = {'N': serial.PARITY_NONE, 'E': serial.PARITY_EVEN,
|
||||
'O': serial.PARITY_ODD}
|
||||
stopbits = {1: serial.STOPBITS_ONE, 2: serial.STOPBITS_TWO}
|
||||
while True:
|
||||
with self._lock:
|
||||
target = self._target
|
||||
cur = self._open_key
|
||||
if target != cur:
|
||||
if self.ser is not None:
|
||||
try:
|
||||
self.ser.close()
|
||||
except Exception:
|
||||
pass
|
||||
self.ser = None
|
||||
self._open_key = None
|
||||
self.on_status('已断开', time.time())
|
||||
if target:
|
||||
port, baud, dbsize, parity, sbits = target
|
||||
try:
|
||||
maker = (serial.serial_for_url if '://' in port
|
||||
else serial.Serial) # '://' 支持 loop:// 等虚拟端口(自检用)
|
||||
self.ser = maker(
|
||||
port, baud, bytesize=bytesizes.get(dbsize, serial.EIGHTBITS),
|
||||
parity=parities.get(parity, serial.PARITY_NONE),
|
||||
stopbits=stopbits.get(sbits, serial.STOPBITS_ONE),
|
||||
timeout=0.15,
|
||||
write_timeout=1.0, # 写超时: 转换器停滞时 write 会
|
||||
# 永久阻塞并卡死线程, 必须设上限
|
||||
inter_byte_timeout=0.02) # 字节间超时(Win32
|
||||
# ReadIntervalTimeout): timeout=0.15 是"总超时"
|
||||
# (150ms 内必返回, 不会无限攒批), 周期上报帧下 read
|
||||
# 会 ~150ms 攒 1~2 帧才返回一批; 设 20ms 后按帧粒度
|
||||
# 返回, 帧到达时间戳精确到单帧。20ms 仍大于 1200 波特
|
||||
# 单字节时间(~8.3ms)×2, 不误切帧
|
||||
with self._lock:
|
||||
self._open_key = target
|
||||
self.parser = None # 换口重建解析器(下次接收时惰性建)
|
||||
self.on_status(f'已连接 {port} @ {baud} {dbsize}{parity}{sbits}',
|
||||
time.time())
|
||||
except Exception as e:
|
||||
self.ser = None
|
||||
with self._lock:
|
||||
self._target = None
|
||||
et = str(e)
|
||||
if 'PermissionError' in repr(e) or '拒绝访问' in et \
|
||||
or 'Access is denied' in et:
|
||||
et += '（串口被占用: 检查串口助手/另一个本工具实例）'
|
||||
self.on_status(f'连接失败: {et}', time.time())
|
||||
if self.ser is not None:
|
||||
try:
|
||||
item = None
|
||||
try:
|
||||
item = self.q.get_nowait()
|
||||
except queue.Empty:
|
||||
pass
|
||||
if item is not None:
|
||||
label, frame = item
|
||||
self.ser.write(frame)
|
||||
if self.on_tx is not None:
|
||||
self.on_tx(label, frame, time.time())
|
||||
data = self.ser.read(4096)
|
||||
if data:
|
||||
self._dispatch_rx(data)
|
||||
except OSError:
|
||||
try:
|
||||
self.ser.close()
|
||||
except Exception:
|
||||
pass
|
||||
self.ser = None
|
||||
self._open_key = None # 必须同步清除, 否则同参数重连被当作已打开而跳过
|
||||
with self._lock:
|
||||
self._target = None
|
||||
self.on_status('串口丢失(设备拔出?), 请重新连接', time.time())
|
||||
time.sleep(0.02)
|
||||
|
||||
def _dispatch_rx(self, data):
|
||||
ts = time.time() # 字节到达时刻: 后台线程打, 随帧携带
|
||||
with self._lock:
|
||||
parse = self._parse
|
||||
if parse and self.parser is None: # 惰性建, 带当前 ProtoConfig
|
||||
from protocol import FrameParser
|
||||
self.parser = FrameParser(self._cfg)
|
||||
if parse:
|
||||
for fr in self.parser.feed(data):
|
||||
if self.on_frame is not None:
|
||||
self.on_frame(fr, ts)
|
||||
elif self.on_raw is not None:
|
||||
self.on_raw(data, ts)
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,61 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
组装 SerialMate 发布包: exe + README → 一个 zip(解压即用)
|
||||
================================================
|
||||
把主 README 复制进 release/ 后, 与单文件 exe 一起压成 zip —— 两者内容一致。
|
||||
|
||||
zip 解压后根目录为 SerialMate/:
|
||||
SerialMate.exe 主程序(先运行 build_exe.py 打包)
|
||||
README.md 使用说明
|
||||
|
||||
用法:
|
||||
python package_release.py 版本号自动取最近 git tag(SerialMate-v*)
|
||||
python package_release.py 0.1.0 手动指定版本号
|
||||
产物: release/SerialMate-v<版本>-win64.zip(zip 不入库, 上传到 Gitea Release)
|
||||
"""
|
||||
|
||||
import os
|
||||
import shutil
|
||||
import subprocess
|
||||
import sys
|
||||
import zipfile
|
||||
|
||||
SRC = os.path.dirname(os.path.abspath(__file__))
|
||||
BASE = os.path.dirname(SRC)
|
||||
RELEASE = os.path.join(BASE, 'release')
|
||||
|
||||
|
||||
def detect_version():
|
||||
"""从最近的 SerialMate-v* tag 推断版本号, 无 tag 则报错提示手动指定"""
|
||||
try:
|
||||
out = subprocess.check_output(
|
||||
['git', 'describe', '--tags', '--abbrev=0', '--match', 'SerialMate-v*'],
|
||||
cwd=BASE, stderr=subprocess.DEVNULL)
|
||||
return out.decode().strip().removeprefix('SerialMate-v')
|
||||
except Exception:
|
||||
sys.exit('未能从 git tag 推断版本号, 请手动指定: python package_release.py <版本号>')
|
||||
|
||||
|
||||
def main():
|
||||
version = (sys.argv[1] if len(sys.argv) > 1 else detect_version()).lstrip('v')
|
||||
exe = os.path.join(RELEASE, 'SerialMate.exe')
|
||||
readme = os.path.join(BASE, 'README.md')
|
||||
if not os.path.exists(exe):
|
||||
sys.exit('缺少 release/SerialMate.exe, 先运行: python build_exe.py')
|
||||
if not os.path.exists(readme):
|
||||
sys.exit(f'缺少 {readme}')
|
||||
|
||||
shutil.copy2(readme, os.path.join(RELEASE, 'README.md'))
|
||||
zip_name = f'SerialMate-v{version}-win64.zip'
|
||||
zip_path = os.path.join(RELEASE, zip_name)
|
||||
with zipfile.ZipFile(zip_path, 'w', zipfile.ZIP_DEFLATED) as z:
|
||||
z.write(exe, f'SerialMate/{os.path.basename(exe)}')
|
||||
z.write(os.path.join(RELEASE, 'README.md'), 'SerialMate/README.md')
|
||||
print(f'发布文件夹: {RELEASE} (exe + README)')
|
||||
print(f'发布包: {zip_path} ({os.path.getsize(zip_path) / 1024 / 1024:.1f} MB)')
|
||||
print('下一步上传: python publish_gitea.py', zip_name)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
@@ -0,0 +1,405 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
轻量滚动曲线控件(QPainter 绘制, 不引入 matplotlib/pyqtgraph)
|
||||
================================================================
|
||||
N 通道时间序列: add(ch, value) 追加点(内部取相对时间), deque 限长滚动丢弃;
|
||||
y 轴自动缩放(全平数据回落 ±1)或 set_yrange 固定量程; 颜色/文字取自当前
|
||||
palette, 明暗主题自动跟随。每通道 >1000 点时抽稀绘制, 3000 点 × 4 通道
|
||||
重绘开销可控。
|
||||
"""
|
||||
|
||||
import bisect
|
||||
import time
|
||||
from collections import deque
|
||||
|
||||
from PySide6.QtCore import QPointF, QRect, Qt
|
||||
from PySide6.QtGui import QColor, QFont, QPainter, QPainterPath, QPen, QPalette
|
||||
from PySide6.QtWidgets import QSizePolicy, QWidget
|
||||
|
||||
|
||||
def fmt_val(v):
|
||||
"""数值可读显示: 普通小数带千分位(最多 4 位小数, 去尾零), 达 10 亿量级
|
||||
才退回科学计数 —— 调试现场 2.821e+07 这类写法不直观"""
|
||||
if v != v or v in (float('inf'), float('-inf')):
|
||||
return str(v)
|
||||
if abs(v) >= 1e9:
|
||||
return f'{v:.4g}'
|
||||
s = f'{v:,.4f}' if abs(v) < 1 else f'{v:,.3f}'
|
||||
return s.rstrip('0').rstrip('.') or '0'
|
||||
|
||||
|
||||
class PlotWidget(QWidget):
|
||||
|
||||
COLORS = ('#0f6cbd', '#d83b01', '#107c10', '#8764b8')
|
||||
MAXLEN = 3000 # 每通道缓冲点数(超限滚动丢弃)
|
||||
M_LEFT, M_TOP, M_RIGHT, M_BOTTOM = 52, 10, 12, 22 # 绘图区内边距
|
||||
|
||||
def __init__(self, channels=4, parent=None):
|
||||
super().__init__(parent)
|
||||
n = channels
|
||||
self._times = [deque(maxlen=self.MAXLEN) for _ in range(n)]
|
||||
self._vals = [deque(maxlen=self.MAXLEN) for _ in range(n)]
|
||||
self._names = [''] * n
|
||||
self._latest = [None] * n
|
||||
self._paused = False
|
||||
self._yrange = None # None=自动 或 (min, max)
|
||||
self._span = None # 可见时间窗宽(秒); None=跟随全部
|
||||
self._offset = 0.0 # 右端距最新数据的秒数(0=实时)
|
||||
self._frozen = False # 暂停渲染: 继续收数但不重绘
|
||||
self._drag_y = None # Y 轴拖动基准(仅手动量程)
|
||||
self.on_yrange_changed = None # 拖动改 Y 量程回调(主界面同步控件)
|
||||
self.on_span_changed = None # 滚轮改时间窗回调(主界面同步下拉)
|
||||
self._hover_pos = None # 悬停光标位置(None=不在绘图区)
|
||||
self._hover_lines = [] # 悬停读值(顶部小框内容)
|
||||
self._t0 = time.perf_counter()
|
||||
self.setMinimumHeight(150)
|
||||
self.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Expanding)
|
||||
self.setMouseTracking(True) # 无按键也接收 mouseMove(悬停读值)
|
||||
|
||||
# --- 数据接口(主线程调用) ---
|
||||
|
||||
def set_channel_name(self, ch, name):
|
||||
self._names[ch] = name
|
||||
self._touch()
|
||||
|
||||
def set_yrange(self, yr):
|
||||
self._yrange = yr
|
||||
self._touch()
|
||||
|
||||
def set_view(self, span):
|
||||
"""设置可见时间窗宽(秒); None=跟随全部数据"""
|
||||
self._span = None if span is None else max(float(span), 1.0)
|
||||
self._touch()
|
||||
|
||||
def set_offset(self, offset):
|
||||
"""可见窗右端距最新数据的秒数(0=实时跟随最新)"""
|
||||
self._offset = max(float(offset), 0.0)
|
||||
self._touch()
|
||||
|
||||
def view_offset(self):
|
||||
return self._offset
|
||||
|
||||
def view_span(self):
|
||||
return self._span
|
||||
|
||||
def view_range(self):
|
||||
"""(全部数据 tmin, tmax, 可回看的最大滞后秒数) —— 供时间滑条换算"""
|
||||
t_all = [t for ts in self._times if ts for t in (ts[0], ts[-1])]
|
||||
tmin = min(t_all) if t_all else 0.0
|
||||
tmax = max(t_all) if t_all else tmin + 5.0
|
||||
span = self._span or max(tmax - tmin, 5.0)
|
||||
return tmin, tmax, max(tmax - tmin - span, 0.0)
|
||||
|
||||
def visible_domain(self, tmin, tmax):
|
||||
"""按时间窗/滞后换算可见横轴域(纯计算, 供单测)。
|
||||
不做数据边界收敛: 选 5min 窗而数据只有 23s 时, 显示完整的 5min 轴,
|
||||
数据贴右端随采集逐渐填满(示波器式); 滞后超出全部历史则为空窗"""
|
||||
if self._span is None:
|
||||
return tmin, tmax
|
||||
right = tmax - self._offset
|
||||
left = right - self._span
|
||||
if right <= left: # 滞后超出全部历史 -> 空窗保宽
|
||||
right = left + self._span
|
||||
return left, right
|
||||
|
||||
def auto_yrange(self):
|
||||
"""自动 Y 量程: 可见数据的 min/max 加 8% 边距(全平数据回落 ±1)"""
|
||||
visible = [v for ch in range(len(self._vals)) for v in self._vals[ch]]
|
||||
if not visible:
|
||||
return -1.0, 1.0
|
||||
ylo, yhi = min(visible), max(visible)
|
||||
if ylo == yhi:
|
||||
return ylo - 1.0, yhi + 1.0
|
||||
pad = (yhi - ylo) * 0.08
|
||||
return ylo - pad, yhi + pad
|
||||
|
||||
def set_paused(self, paused):
|
||||
self._paused = bool(paused)
|
||||
|
||||
def is_paused(self):
|
||||
return self._paused
|
||||
|
||||
def set_frozen(self, frozen):
|
||||
"""暂停渲染(弹窗用): 继续接收入库但不重绘; 解冻后一次性渲染全部积累。
|
||||
冻结是绝对状态: 覆写 update() 吞掉一切重绘请求, 任何代码路径都无法
|
||||
在冻结期打破(悬停/滑条等), 只有 set_frozen(False) 恢复"""
|
||||
self._frozen = bool(frozen)
|
||||
if not self._frozen:
|
||||
super().update()
|
||||
|
||||
def is_frozen(self):
|
||||
return self._frozen
|
||||
|
||||
def update(self):
|
||||
if self._frozen:
|
||||
return
|
||||
super().update()
|
||||
|
||||
def _touch(self):
|
||||
self.update()
|
||||
|
||||
def add(self, ch, value):
|
||||
if self._paused or value is None:
|
||||
return
|
||||
self._times[ch].append(time.perf_counter() - self._t0)
|
||||
self._vals[ch].append(float(value))
|
||||
self._latest[ch] = float(value)
|
||||
self._touch()
|
||||
|
||||
def clear(self):
|
||||
for t in self._times:
|
||||
t.clear()
|
||||
for v in self._vals:
|
||||
v.clear()
|
||||
self._latest = [None] * len(self._latest)
|
||||
self._touch()
|
||||
|
||||
# --- 悬停读值 ---
|
||||
|
||||
def _nearest(self, ch, t, tol):
|
||||
"""通道 ch 在时刻 t 附近(±tol 秒)最近的采样点 -> (名称, 值) 或 None"""
|
||||
ts, vs = self._times[ch], self._vals[ch]
|
||||
if not ts:
|
||||
return None
|
||||
lst = list(ts) # deque 无随机 bisect, 拷贝代价可接受
|
||||
i = bisect.bisect_left(lst, t)
|
||||
best = None
|
||||
for j in (i - 1, i):
|
||||
if 0 <= j < len(lst) and abs(lst[j] - t) <= tol:
|
||||
if best is None or abs(lst[j] - t) < abs(lst[best] - t):
|
||||
best = j
|
||||
if best is None:
|
||||
return None
|
||||
return self._names[ch] or f'CH{ch + 1}', vs[best]
|
||||
|
||||
def _plot_geometry(self):
|
||||
"""绘图区几何与可见横轴域: (left, top, pw, ph, tmin, tmax)"""
|
||||
left, top = self.M_LEFT, self.M_TOP
|
||||
pw = self.width() - left - self.M_RIGHT
|
||||
ph = self.height() - top - self.M_BOTTOM
|
||||
t_all = [t for ts in self._times if ts for t in (ts[0], ts[-1])]
|
||||
if t_all:
|
||||
tmin, tmax = min(t_all), max(t_all)
|
||||
else:
|
||||
tmin, tmax = 0.0, 5.0
|
||||
tmin, tmax = self.visible_domain(tmin, tmax)
|
||||
return left, top, pw, ph, tmin, tmax
|
||||
|
||||
def wheelEvent(self, ev):
|
||||
"""滚轮缩放时间窗: 上滚放大(窗宽变短), 下滚缩小; 滞后按比例缩放"""
|
||||
delta = ev.angleDelta().y()
|
||||
if delta:
|
||||
factor = 0.8 if delta > 0 else 1.25
|
||||
old = self._span
|
||||
if old is None: # 跟随模式 -> 以当前数据跨度为基准
|
||||
_tmin, tmax, _mp = self.view_range()
|
||||
old = max(tmax - _tmin, 5.0)
|
||||
new = max(min(old * factor, 900.0), 2.0)
|
||||
if self._offset and old:
|
||||
self._offset = self._offset * new / old
|
||||
self.set_view(new)
|
||||
if self.on_span_changed is not None:
|
||||
self.on_span_changed()
|
||||
super().wheelEvent(ev)
|
||||
|
||||
def mousePressEvent(self, ev):
|
||||
if ev.button() == Qt.LeftButton and self._yrange is not None:
|
||||
self._drag_y = ev.position().toPoint().y()
|
||||
super().mousePressEvent(ev)
|
||||
|
||||
def mouseReleaseEvent(self, ev):
|
||||
if ev.button() == Qt.LeftButton:
|
||||
self._drag_y = None
|
||||
super().mouseReleaseEvent(ev)
|
||||
|
||||
def mouseMoveEvent(self, ev):
|
||||
pos = ev.position().toPoint()
|
||||
if self._drag_y is not None and self._yrange is not None:
|
||||
_left, _top, _pw, ph, *_rest = self._plot_geometry()
|
||||
if ph > 40:
|
||||
ylo, yhi = self._yrange
|
||||
shift = (yhi - ylo) * (pos.y() - self._drag_y) / ph
|
||||
yr = (ylo - shift, yhi - shift) # 下拖数据下移, 上拖上移
|
||||
self.set_yrange(yr)
|
||||
if self.on_yrange_changed is not None:
|
||||
self.on_yrange_changed(yr)
|
||||
self._drag_y = pos.y()
|
||||
self._hover_pos = pos
|
||||
self.update()
|
||||
super().mouseMoveEvent(ev)
|
||||
|
||||
def leaveEvent(self, ev):
|
||||
self._hover_pos = None
|
||||
self.update()
|
||||
super().leaveEvent(ev)
|
||||
|
||||
def _hover_lines_at(self, pos):
|
||||
"""光标位置 -> 读值框内容; 不在绘图区/无命中返回空列表。
|
||||
由 paintEvent 每帧调用(而非仅在鼠标移动时), 鼠标停住不动,
|
||||
实时数据到来时读值依然持续刷新(用户实测反馈)"""
|
||||
left, top, pw, ph, tmin, tmax = self._plot_geometry()
|
||||
span = max(tmax - tmin, 0.001)
|
||||
if pw < 40 or ph < 40 or not (left <= pos.x() <= left + pw) \
|
||||
or not (top <= pos.y() <= top + ph):
|
||||
return []
|
||||
t = tmin + (pos.x() - left) / pw * span
|
||||
tol = span / max(pw, 1) * 10 # 光标 ±10px 内的采样算命中
|
||||
lines = [f'T = {t:.2f}s']
|
||||
for ch in range(len(self._vals)):
|
||||
got = self._nearest(ch, t, tol)
|
||||
if got:
|
||||
lines.append(f'{got[0]} = {fmt_val(got[1])}')
|
||||
return lines if len(lines) > 1 else []
|
||||
|
||||
# --- 绘制 ---
|
||||
|
||||
def paintEvent(self, _ev):
|
||||
p = QPainter(self)
|
||||
p.setRenderHint(QPainter.Antialiasing)
|
||||
rect = self.rect()
|
||||
pal = self.palette()
|
||||
p.fillRect(rect, pal.color(QPalette.Base))
|
||||
text = pal.color(QPalette.WindowText)
|
||||
dim = QColor(text)
|
||||
dim.setAlpha(110)
|
||||
grid = QColor(text)
|
||||
grid.setAlpha(38)
|
||||
|
||||
left, top = self.M_LEFT, self.M_TOP
|
||||
right, bottom = self.M_RIGHT, self.M_BOTTOM
|
||||
pw, ph = rect.width() - left - right, rect.height() - top - bottom
|
||||
if pw < 40 or ph < 40:
|
||||
return
|
||||
|
||||
p.setFont(QFont(self.font().family(), 8))
|
||||
p.setPen(dim)
|
||||
|
||||
# y 量程: 固定 或 自动(auto_yrange: 8% 边距, 全平数据回落 ±1)
|
||||
if self._yrange is not None:
|
||||
ylo, yhi = self._yrange
|
||||
if ylo >= yhi:
|
||||
yhi = ylo + 1.0
|
||||
else:
|
||||
ylo, yhi = self.auto_yrange()
|
||||
|
||||
def my(y): # 值 -> 像素 y
|
||||
return top + (yhi - y) / (yhi - ylo) * ph
|
||||
|
||||
# 横向参考线(4 等分)与每条线上的纵轴数值刻度
|
||||
p.setPen(QPen(grid, 1, Qt.DashLine))
|
||||
for i in range(1, 4):
|
||||
y = top + ph * i / 4
|
||||
p.drawLine(left, int(y), left + pw, int(y))
|
||||
for i in range(1, 6):
|
||||
x = left + pw * i / 6
|
||||
p.drawLine(int(x), top, int(x), top + ph)
|
||||
p.setPen(dim)
|
||||
for i in range(5):
|
||||
v = yhi - (yhi - ylo) * i / 4
|
||||
y = top + ph * i / 4
|
||||
p.drawText(QRect(2, int(y) - 9, left - 8, 18),
|
||||
Qt.AlignRight | Qt.AlignVCenter, fmt_val(v))
|
||||
|
||||
# x 范围: 时间窗(span)内、按滞后(offset)取可见域; 无窗宽则跟随全部数据
|
||||
t_all = [t for ch in range(len(self._times)) if self._times[ch]
|
||||
for t in (self._times[ch][0], self._times[ch][-1])]
|
||||
if t_all:
|
||||
tmin, tmax = min(t_all), max(t_all)
|
||||
else:
|
||||
tmin, tmax = 0.0, 5.0
|
||||
data_span = tmax - tmin
|
||||
tmin, tmax = self.visible_domain(tmin, tmax)
|
||||
span = max(tmax - tmin, 0.001)
|
||||
|
||||
def mx(t): # 时间 -> 像素 x
|
||||
return left + (t - tmin) / span * pw
|
||||
|
||||
empty = True
|
||||
for ch in range(len(self._vals)):
|
||||
ts, vs = self._times[ch], self._vals[ch]
|
||||
n = len(vs)
|
||||
if n == 0:
|
||||
continue
|
||||
empty = False
|
||||
color = QColor(self.COLORS[ch % len(self.COLORS)])
|
||||
p.setPen(QPen(color, 1.6))
|
||||
if n == 1:
|
||||
p.drawEllipse(QPointF(mx(ts[0]), my(vs[0])), 2.2, 2.2)
|
||||
continue
|
||||
step = max(1, n // 1000)
|
||||
path = QPainterPath(QPointF(mx(ts[0]), my(vs[0])))
|
||||
for i in range(step, n, step):
|
||||
path.lineTo(mx(ts[i]), my(vs[i]))
|
||||
path.lineTo(mx(ts[-1]), my(vs[-1]))
|
||||
p.drawPath(path)
|
||||
|
||||
p.setPen(dim)
|
||||
tag = '窗口' if self._span is not None else '最近'
|
||||
if self._span is not None and data_span < self._span - 0.5:
|
||||
label = f'已采集 {data_span:.0f}s / 窗口 {self._span:.0f}s'
|
||||
else:
|
||||
label = f'{tag} {span:.0f}s' if span >= 10 else f'{tag} {span:.1f}s'
|
||||
p.drawText(rect.adjusted(0, rect.height() - 18, -4, 0),
|
||||
Qt.AlignRight | Qt.AlignVCenter, label)
|
||||
if self._hover_pos is not None:
|
||||
self._hover_lines = self._hover_lines_at(self._hover_pos)
|
||||
if self._hover_lines:
|
||||
self._hover_box(p)
|
||||
if empty:
|
||||
p.drawText(rect, Qt.AlignCenter, '等待数据…(勾选通道并使能接收)')
|
||||
elif self._paused:
|
||||
p.drawText(rect.adjusted(0, top, 0, 0), Qt.AlignHCenter, '已暂停')
|
||||
elif self._frozen:
|
||||
p.drawText(rect.adjusted(0, top, 0, 0), Qt.AlignHCenter,
|
||||
'已冻结渲染(采集继续)')
|
||||
self._legend(p, rect, text)
|
||||
|
||||
def _hover_box(self, p):
|
||||
"""顶部居中的悬停读值小框(反色底), 内容在 mouseMove 里持续刷新"""
|
||||
p.setFont(QFont(self.font().family(), 9))
|
||||
fm = p.fontMetrics()
|
||||
w = max(fm.horizontalAdvance(s) for s in self._hover_lines) + 16
|
||||
h = fm.height() * len(self._hover_lines) + 10
|
||||
x = self.M_LEFT + (self.width() - self.M_LEFT - self.M_RIGHT - w) // 2
|
||||
y = self.M_TOP + 6
|
||||
bg = QColor(self.palette().color(QPalette.WindowText))
|
||||
bg.setAlpha(210)
|
||||
p.setPen(Qt.NoPen)
|
||||
p.setBrush(bg)
|
||||
p.drawRoundedRect(x, y, w, h, 4, 4)
|
||||
p.setPen(self.palette().color(QPalette.Base))
|
||||
for i, s in enumerate(self._hover_lines):
|
||||
p.drawText(x + 8, y + 5 + i * fm.height(), w - 16, fm.height(),
|
||||
Qt.AlignLeft | Qt.AlignVCenter, s)
|
||||
p.setBrush(Qt.NoBrush)
|
||||
|
||||
def _legend(self, p, rect, text):
|
||||
"""右上角图例: 色块 + 通道名 + 最新值"""
|
||||
lines = []
|
||||
for ch in range(len(self._vals)):
|
||||
if self._latest[ch] is None:
|
||||
continue
|
||||
name = self._names[ch] or f'CH{ch + 1}'
|
||||
lines.append((ch, f'{name} = {fmt_val(self._latest[ch])}'))
|
||||
if not lines:
|
||||
return
|
||||
p.setFont(QFont(self.font().family(), 8))
|
||||
fm = p.fontMetrics()
|
||||
w = max(fm.horizontalAdvance(s) for _c, s in lines) + 26
|
||||
h = fm.height() * len(lines) + 8
|
||||
x1, y1 = rect.width() - 16 - w, 8
|
||||
bg = QColor(text)
|
||||
bg.setAlpha(18)
|
||||
p.setPen(Qt.NoPen)
|
||||
p.setBrush(bg)
|
||||
p.drawRoundedRect(x1, y1, w, h, 4, 4)
|
||||
p.setBrush(Qt.NoBrush)
|
||||
for i, (ch, s) in enumerate(lines):
|
||||
y = y1 + 4 + i * fm.height()
|
||||
p.setPen(Qt.NoPen)
|
||||
p.setBrush(QColor(self.COLORS[ch % len(self.COLORS)]))
|
||||
p.drawRect(x1 + 6, y + fm.ascent() - 8, 8, 8)
|
||||
p.setPen(self.palette().color(QPalette.WindowText))
|
||||
p.drawText(x1 + 20, y, w - 22, fm.height(),
|
||||
Qt.AlignLeft | Qt.AlignVCenter, s)
|
||||
@@ -0,0 +1,450 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
SerialAssistant 串口协议模块(纯标准库, 帧构成可定制)
|
||||
======================================================
|
||||
帧由"构成令牌序列"定义(默认与 DLPilot 光机 RS485 协议完全一致):
|
||||
HDR ID LEN PAYLOAD CRC -> 包头 + 板ID + LEN + payload + CRC
|
||||
LEN = payload 字节数(口径可选, 见 LEN_SEMS), 默认即"包长对应 payload 长度"
|
||||
令牌: HDR=包头 ID=板ID LEN=长度 PAYLOAD=载荷 CRC=校验(必须最后),
|
||||
其余 1~2 位十六进制(如 AA 55)为固定字面量字节(双字节同步头)。
|
||||
约束: LEN/PAYLOAD/CRC 恰好各一次; LEN 前至少一个 HDR 或字面量(同步定界用)。
|
||||
同一布局收发共用, 仅包头值分方向(TX=tx_hdr / RX=rx_hdr); ID 在 RX 侧
|
||||
按上游语义多为响应 TYPE 码, 解析时不校验、原样透出(Frame.code, 可为 None)。
|
||||
|
||||
CRC 算法(2 字节算法在线上的字节序: MODBUS 低位在前, 其余高位在前):
|
||||
SUM8 累加和取低 8 位(1 字节)
|
||||
CRC8 poly 0x07 init 0x00(1 字节, 标准校验值 check("123456789")=0xF4)
|
||||
CRC16_MODBUS poly 0x8005 反射 init 0xFFFF(2 字节, check=0x4B37)
|
||||
CRC16_XMODEM poly 0x1021 init 0x0000(2 字节, check=0x31C3)
|
||||
CRC16_CCITT poly 0x1021 init 0xFFFF(2 字节, check=0x29B1)
|
||||
|
||||
CRC 覆盖范围(CRC_SCOPES, 按帧内位置定义, 任意布局通用):
|
||||
with_header 包头(第1字节)起至 CRC 前
|
||||
no_header 第 2 字节起至 CRC 前(DLPilot 默认)
|
||||
payload_only 仅 payload
|
||||
|
||||
仅标准库; pyserial 只允许出现在 link.py。
|
||||
"""
|
||||
|
||||
import collections
|
||||
import re
|
||||
import struct
|
||||
|
||||
LEN_MAX = 255 # LEN 为单字节, payload 上限 255
|
||||
|
||||
TYPE_NAMES = { # DLPilot/上游 protocols.md 的响应 TYPE 码语义, 用于 RX 译码显示
|
||||
0xF0: '成功',
|
||||
0xF1: 'CRC 校验错',
|
||||
0xF2: '包头错',
|
||||
0xF3: '板类型错',
|
||||
0xF4: '格式/缺参数',
|
||||
0xFD: '参数越界/读回复核不一致',
|
||||
0xFE: '未知命令',
|
||||
0xFF: '通用错误(含就绪门禁拒绝)',
|
||||
0xFA: '开光机通信失败',
|
||||
0xFB: '关光机通信失败',
|
||||
0xFC: '读回复核通信失败',
|
||||
}
|
||||
|
||||
|
||||
# --- CRC 实现(查表, 供高波特率下增量解析用) ---------------------------------
|
||||
|
||||
def _table_crc8():
|
||||
tbl = []
|
||||
for b in range(256):
|
||||
c = b
|
||||
for _ in range(8):
|
||||
c = ((c << 1) ^ 0x07) & 0xFF if c & 0x80 else (c << 1) & 0xFF
|
||||
tbl.append(c)
|
||||
return tuple(tbl)
|
||||
|
||||
|
||||
def _table_crc16_msb():
|
||||
"""MSB-first 表(poly 0x1021, 用于 XMODEM/CCITT)"""
|
||||
tbl = []
|
||||
for b in range(256):
|
||||
c = (b << 8) & 0xFFFF
|
||||
for _ in range(8):
|
||||
c = ((c << 1) ^ 0x1021) & 0xFFFF if c & 0x8000 else (c << 1) & 0xFFFF
|
||||
tbl.append(c)
|
||||
return tuple(tbl)
|
||||
|
||||
|
||||
def _table_crc16_reflected():
|
||||
"""反射表(poly 0x8005 → 0xA001, 用于 MODBUS)"""
|
||||
tbl = []
|
||||
for b in range(256):
|
||||
c = b
|
||||
for _ in range(8):
|
||||
c = (c >> 1) ^ 0xA001 if c & 1 else c >> 1
|
||||
tbl.append(c)
|
||||
return tuple(tbl)
|
||||
|
||||
|
||||
_TAB_CRC8 = _table_crc8()
|
||||
_TAB_CRC16_MSB = _table_crc16_msb()
|
||||
_TAB_CRC16_REF = _table_crc16_reflected()
|
||||
|
||||
|
||||
def _sum8(data):
|
||||
return sum(data) & 0xFF
|
||||
|
||||
|
||||
def _crc8(data, _t=_TAB_CRC8):
|
||||
c = 0
|
||||
for b in data:
|
||||
c = _t[c ^ b]
|
||||
return c
|
||||
|
||||
|
||||
def _crc16_msb(data, init, _t=_TAB_CRC16_MSB):
|
||||
c = init
|
||||
for b in data:
|
||||
c = ((c << 8) & 0xFFFF) ^ _t[((c >> 8) ^ b) & 0xFF]
|
||||
return c
|
||||
|
||||
|
||||
def _crc16_xmodem(data):
|
||||
return _crc16_msb(data, 0x0000)
|
||||
|
||||
|
||||
def _crc16_ccitt(data):
|
||||
return _crc16_msb(data, 0xFFFF)
|
||||
|
||||
|
||||
def _crc16_modbus(data, _t=_TAB_CRC16_REF):
|
||||
c = 0xFFFF
|
||||
for b in data:
|
||||
c = (c >> 8) ^ _t[(c ^ b) & 0xFF]
|
||||
return c
|
||||
|
||||
|
||||
# name -> (CRC 字节数, 计算函数, 线上字节序: 'big'=高字节在前 / 'little'=低字节在前)
|
||||
CRC_ALGOS = {
|
||||
'SUM8': (1, _sum8, 'big'),
|
||||
'CRC8': (1, _crc8, 'big'),
|
||||
'CRC16_MODBUS': (2, _crc16_modbus, 'little'),
|
||||
'CRC16_XMODEM': (2, _crc16_xmodem, 'big'),
|
||||
'CRC16_CCITT': (2, _crc16_ccitt, 'big'),
|
||||
}
|
||||
CRC_ALGO_LABELS = { # 下拉框显示文本
|
||||
'SUM8': 'SUM8 累加和',
|
||||
'CRC8': 'CRC8 (poly 07)',
|
||||
'CRC16_MODBUS': 'CRC16 MODBUS',
|
||||
'CRC16_XMODEM': 'CRC16 XMODEM',
|
||||
'CRC16_CCITT': 'CRC16 CCITT-FALSE',
|
||||
}
|
||||
CRC_SCOPES = ('with_header', 'no_header', 'payload_only')
|
||||
CRC_SCOPE_LABELS = {
|
||||
'with_header': '含包头(整帧不含CRC)',
|
||||
'no_header': '不含包头(跳过第1字节, DLPilot)',
|
||||
'payload_only': '仅 payload',
|
||||
}
|
||||
LEN_SEMS = ('payload', 'body', 'total')
|
||||
LEN_SEM_LABELS = { # LEN 字节的计数口径
|
||||
'payload': 'payload 长度(默认)',
|
||||
'body': '到帧尾(payload+CRC)',
|
||||
'total': '整帧(含包头)',
|
||||
}
|
||||
|
||||
DEFAULT_LAYOUT = 'HDR ID LEN PAYLOAD CRC'
|
||||
_FRAME_TOKEN_RE = re.compile(r'^(?:0x)?([0-9A-Fa-f]{1,2})$')
|
||||
_KEYWORDS = {'HDR': 'hdr', 'ID': 'id', 'BOARD': 'id', 'LEN': 'len',
|
||||
'PAYLOAD': 'payload', 'DATA': 'payload', 'CRC': 'crc'}
|
||||
|
||||
|
||||
class FrameLayout:
|
||||
"""帧构成: 令牌序列(parse 文本而来), 供组帧与解析共用。
|
||||
|
||||
tokens 元素: 'hdr'/'id'/'len'/'payload'/'crc' 或 ('lit', 字节值)。
|
||||
约束(parse 内校验): LEN/PAYLOAD/CRC 恰好各一次; CRC 必须最后;
|
||||
LEN 之前至少一个 HDR 或字面量(否则无同步定界); ID 最多一次。
|
||||
payload 之前的令牌都是 1 字节(CRC 在最后), 故 payload 字节偏移=payload_pos。
|
||||
"""
|
||||
|
||||
def __init__(self, tokens):
|
||||
self.tokens = tuple(tokens)
|
||||
counts = collections.Counter(
|
||||
t if isinstance(t, str) else 'lit' for t in self.tokens)
|
||||
for key, cn in (('len', 'LEN'), ('payload', 'PAYLOAD'), ('crc', 'CRC')):
|
||||
if counts[key] != 1:
|
||||
raise ValueError(f'{cn} 必须恰好出现一次(当前 {counts[key]} 次)')
|
||||
if self.tokens[-1] != 'crc':
|
||||
raise ValueError('CRC 必须是最后一个令牌')
|
||||
if counts['id'] > 1:
|
||||
raise ValueError('ID 最多出现一次')
|
||||
self.len_pos = self.tokens.index('len')
|
||||
self.payload_pos = self.tokens.index('payload')
|
||||
id_positions = [i for i, t in enumerate(self.tokens) if t == 'id']
|
||||
self.id_pos = id_positions[0] if id_positions else None
|
||||
if not any(isinstance(t, tuple) or t == 'hdr'
|
||||
for t in self.tokens[:self.len_pos]):
|
||||
raise ValueError('LEN 之前需要至少一个 HDR 或十六进制字面量作同步头')
|
||||
|
||||
@classmethod
|
||||
def parse(cls, text):
|
||||
"""'AA 55 ID LEN PAYLOAD CRC' 之类 -> FrameLayout; 非法抛 ValueError"""
|
||||
parts = [p for p in re.split(r'[\s,，;；]+', (text or '').strip()) if p]
|
||||
if not parts:
|
||||
raise ValueError('帧构成为空')
|
||||
tokens = []
|
||||
for p in parts:
|
||||
kw = _KEYWORDS.get(p.upper())
|
||||
if kw:
|
||||
tokens.append(kw)
|
||||
continue
|
||||
m = _FRAME_TOKEN_RE.match(p)
|
||||
if not m:
|
||||
raise ValueError(f'未知令牌 "{p}"(可用: HDR ID LEN PAYLOAD CRC '
|
||||
f'或 0~FF 十六进制字面量)')
|
||||
tokens.append(('lit', int(m.group(1), 16)))
|
||||
return cls(tokens)
|
||||
|
||||
# --- 尺寸(依赖 CRC 字节数, 由 ProtoConfig 传参) ---
|
||||
|
||||
def rest_size(self, crc_size):
|
||||
"""payload 之后的字节数(ID/HDR/字面量 + CRC)"""
|
||||
return crc_size + len(self.tokens) - self.payload_pos - 2
|
||||
|
||||
def total_size(self, payload_len, crc_size):
|
||||
# payload 之前的令牌都是 1 字节, payload 字节偏移即 payload_pos
|
||||
return self.payload_pos + payload_len + self.rest_size(crc_size)
|
||||
|
||||
def len_extra(self, len_sem, crc_size):
|
||||
"""LEN 字节值 = payload_len + 该口径下的附加字节数"""
|
||||
if len_sem == 'body':
|
||||
return self.rest_size(crc_size)
|
||||
if len_sem == 'total':
|
||||
return self.payload_pos + self.rest_size(crc_size)
|
||||
return 0
|
||||
|
||||
|
||||
Frame = collections.namedtuple('Frame', 'code payload raw')
|
||||
"""code=ID 位置字节(RX 侧多为响应 TYPE 码; 布局无 ID 时为 None),
|
||||
payload=原始字节, raw=整帧含 CRC"""
|
||||
|
||||
|
||||
class ProtoConfig:
|
||||
"""协议配置: 帧构成(FrameLayout) + 包头(TX/RX)/板ID/LEN 口径/CRC 算法与覆盖"""
|
||||
|
||||
def __init__(self, tx_hdr=0xD5, rx_hdr=0xB5, board=0x01,
|
||||
crc_algo='SUM8', crc_scope='no_header',
|
||||
layout=None, len_sem='payload'):
|
||||
for name, v in (('tx_hdr', tx_hdr), ('rx_hdr', rx_hdr), ('board', board)):
|
||||
if not 0 <= int(v) <= 0xFF:
|
||||
raise ValueError(f'{name} 超出 0~255: {v}')
|
||||
if crc_algo not in CRC_ALGOS:
|
||||
raise ValueError(f'未知 CRC 算法: {crc_algo}')
|
||||
if crc_scope not in CRC_SCOPES:
|
||||
raise ValueError(f'未知 CRC 覆盖范围: {crc_scope}')
|
||||
if len_sem not in LEN_SEMS:
|
||||
raise ValueError(f'未知 LEN 口径: {len_sem}')
|
||||
self.tx_hdr, self.rx_hdr, self.board = int(tx_hdr), int(rx_hdr), int(board)
|
||||
self.crc_algo, self.crc_scope = crc_algo, crc_scope
|
||||
self.len_sem = len_sem
|
||||
self.layout = layout if layout is not None else FrameLayout.parse(DEFAULT_LAYOUT)
|
||||
|
||||
@property
|
||||
def crc_size(self):
|
||||
return CRC_ALGOS[self.crc_algo][0]
|
||||
|
||||
# --- CRC ---
|
||||
|
||||
def compute_crc(self, nocrc_frame, payload_len):
|
||||
"""对不含 CRC 的整帧按覆盖范围切片算 CRC 值(切片按位置定义, 任意布局通用)"""
|
||||
_size, fn, _order = CRC_ALGOS[self.crc_algo]
|
||||
if self.crc_scope == 'no_header':
|
||||
region = nocrc_frame[1:]
|
||||
elif self.crc_scope == 'payload_only':
|
||||
po = self.layout.payload_pos
|
||||
region = nocrc_frame[po:po + payload_len]
|
||||
else:
|
||||
region = nocrc_frame
|
||||
return fn(region)
|
||||
|
||||
def encode_crc(self, value):
|
||||
"""CRC 值 -> 线上字节(2 字节算法按算法约定字节序)"""
|
||||
size, _fn, order = CRC_ALGOS[self.crc_algo]
|
||||
if size == 1:
|
||||
return bytes((value & 0xFF,))
|
||||
hi, lo = (value >> 8) & 0xFF, value & 0xFF
|
||||
return bytes((hi, lo)) if order == 'big' else bytes((lo, hi))
|
||||
|
||||
# --- 组帧 ---
|
||||
|
||||
def build_frame(self, payload):
|
||||
"""payload bytes -> 完整帧 bytes; 空载荷允许(LEN=0), 超限抛 ValueError"""
|
||||
payload = bytes(payload)
|
||||
if len(payload) > LEN_MAX:
|
||||
raise ValueError(f'payload 超长(>{LEN_MAX} 字节)')
|
||||
cs = self.crc_size
|
||||
len_val = len(payload) + self.layout.len_extra(self.len_sem, cs)
|
||||
if len_val > LEN_MAX:
|
||||
raise ValueError(f'LEN 字节溢出(={len_val}>255), 检查帧构成与 LEN 口径')
|
||||
parts = []
|
||||
for tok in self.layout.tokens:
|
||||
if tok == 'crc':
|
||||
continue # CRC 最后, 跳过待拼
|
||||
if tok == 'hdr':
|
||||
parts.append(bytes((self.tx_hdr,)))
|
||||
elif tok == 'id':
|
||||
parts.append(bytes((self.board,)))
|
||||
elif tok == 'len':
|
||||
parts.append(bytes((len_val,)))
|
||||
elif tok == 'payload':
|
||||
parts.append(payload)
|
||||
else:
|
||||
parts.append(bytes((tok[1],)))
|
||||
nocrc = b''.join(parts)
|
||||
return nocrc + self.encode_crc(self.compute_crc(nocrc, len(payload)))
|
||||
|
||||
# --- 校验与拆帧 ---
|
||||
|
||||
def _plen_of(self, raw):
|
||||
"""从整帧 LEN 字节解出 payload 长度; 非法(负值)返回 None"""
|
||||
plen = raw[self.layout.len_pos] - self.layout.len_extra(self.len_sem, self.crc_size)
|
||||
return plen if plen >= 0 else None
|
||||
|
||||
def verify_frame(self, raw):
|
||||
"""整帧(含 CRC)校验: 长度与 LEN 口径自洽 + CRC 匹配"""
|
||||
cs = self.crc_size
|
||||
if len(raw) < self.layout.len_pos + 1 + cs:
|
||||
return False
|
||||
plen = self._plen_of(raw)
|
||||
if plen is None or len(raw) != self.layout.total_size(plen, cs):
|
||||
return False
|
||||
return self.encode_crc(self.compute_crc(raw[:-cs], plen)) == raw[-cs:]
|
||||
|
||||
def parse_frame(self, raw):
|
||||
"""整帧 -> Frame(不校验 CRC, 调用方先用 verify_frame); 长度不符抛 ValueError"""
|
||||
cs = self.crc_size
|
||||
plen = self._plen_of(raw)
|
||||
if plen is None or len(raw) != self.layout.total_size(plen, cs):
|
||||
raise ValueError('帧长与 LEN 口径不符')
|
||||
po = self.layout.payload_pos
|
||||
code = raw[self.layout.id_pos] if self.layout.id_pos is not None else None
|
||||
return Frame(code, raw[po:po + plen], bytes(raw))
|
||||
|
||||
|
||||
class FrameParser:
|
||||
"""增量字节流 -> 完整帧: 前缀令牌逐位对齐(帧头/字面量, ID 为通配) + LEN 定长
|
||||
+ CRC 校验; 任一处失配丢 1 字节重新同步。LEN 值经口径换算后即 payload 长度,
|
||||
负值视为伪帧头逐出 —— 伪帧头最多滞留一帧即被逐出重同步, 对调试工具可接受。
|
||||
"""
|
||||
|
||||
def __init__(self, cfg):
|
||||
self.cfg = cfg
|
||||
lay = cfg.layout
|
||||
cs = cfg.crc_size
|
||||
# LEN 之前的前缀令牌: (帧内位置, 期望字节|None=通配); hdr 按 RX 包头匹配
|
||||
self._prefix = []
|
||||
for pos, tok in enumerate(lay.tokens[:lay.len_pos]):
|
||||
exp = None
|
||||
if tok == 'hdr':
|
||||
exp = cfg.rx_hdr
|
||||
elif isinstance(tok, tuple):
|
||||
exp = tok[1]
|
||||
self._prefix.append((pos, exp))
|
||||
self._len_pos = lay.len_pos
|
||||
self._extra = lay.len_extra(cfg.len_sem, cs)
|
||||
self._buf = bytearray()
|
||||
|
||||
def clear(self):
|
||||
self._buf.clear()
|
||||
|
||||
def _aligned(self):
|
||||
"""把缓冲对齐到前缀匹配; 字节不足且已匹配部分则保持等待(返回 True),
|
||||
失配丢 1 字节重试, 缓冲耗尽返回 False"""
|
||||
buf = self._buf
|
||||
while True:
|
||||
for pos, exp in self._prefix:
|
||||
if pos >= len(buf):
|
||||
return True # 已匹配部分全对, 等更多字节
|
||||
if exp is not None and buf[pos] != exp:
|
||||
break # 失配 -> 丢 1 字节
|
||||
else:
|
||||
return True
|
||||
del buf[:1]
|
||||
if not buf:
|
||||
return False
|
||||
|
||||
def feed(self, data):
|
||||
"""喂入新收到的字节, 返回本次解析出的完整 Frame 列表"""
|
||||
self._buf += bytes(data)
|
||||
cfg, frames = self.cfg, []
|
||||
while self._aligned() and self._buf:
|
||||
if len(self._buf) < self._len_pos + 1:
|
||||
break # LEN 字节未到齐
|
||||
plen = self._buf[self._len_pos] - self._extra
|
||||
if plen < 0: # LEN 为负 -> 伪帧头, 逐出重同步
|
||||
del self._buf[:1]
|
||||
continue
|
||||
total = cfg.layout.total_size(plen, cfg.crc_size)
|
||||
if len(self._buf) < total:
|
||||
break # 整帧未收齐
|
||||
raw = bytes(self._buf[:total])
|
||||
if cfg.verify_frame(raw):
|
||||
frames.append(cfg.parse_frame(raw))
|
||||
del self._buf[:total]
|
||||
else:
|
||||
del self._buf[:1] # CRC 失配 -> 丢帧头重同步
|
||||
return frames
|
||||
|
||||
|
||||
# --- payload 数值提取(曲线通道用) --------------------------------------------
|
||||
|
||||
BIN_FORMATS = { # fmt -> (struct 格式, 字节数)
|
||||
'u8': ('B', 1), 's8': ('b', 1),
|
||||
'u16be': ('>H', 2), 'u16le': ('<H', 2),
|
||||
's16be': ('>h', 2), 's16le': ('<h', 2),
|
||||
'u32be': ('>I', 4), 'u32le': ('<I', 4),
|
||||
's32be': ('>i', 4), 's32le': ('<i', 4),
|
||||
'f32be': ('>f', 4), 'f32le': ('<f', 4),
|
||||
}
|
||||
NUM_RE = re.compile(r'-?\d+(?:\.\d+)?')
|
||||
|
||||
|
||||
def extract_value(payload, mode, *, offset=0, fmt='u16be', index=1,
|
||||
pattern=r'(?<=:)\d+', scale=1.0):
|
||||
"""从 payload 提取一个数值(已乘 scale); 提取失败返回 None。
|
||||
|
||||
bin 二进制定长提取: offset 起, 按 fmt(BIN_FORMATS 键)解
|
||||
num ASCII 文本第 index(1 基)个数字, 如 'okTL:246' -> 246
|
||||
re 正则第 1 捕获组(无组则整体), 如 '(?<=:)(\\d+)'
|
||||
"""
|
||||
payload = bytes(payload)
|
||||
try:
|
||||
if mode == 'bin':
|
||||
if fmt not in BIN_FORMATS:
|
||||
return None
|
||||
sfmt, size = BIN_FORMATS[fmt]
|
||||
if offset < 0 or len(payload) < offset + size:
|
||||
return None
|
||||
value = struct.unpack(sfmt, payload[offset:offset + size])[0]
|
||||
elif mode == 'num':
|
||||
nums = NUM_RE.findall(payload.decode('ascii', 'replace'))
|
||||
if not 1 <= index <= len(nums):
|
||||
return None
|
||||
value = float(nums[index - 1])
|
||||
elif mode == 're':
|
||||
m = re.search(pattern, payload.decode('ascii', 'replace'))
|
||||
if not m:
|
||||
return None
|
||||
value = float(m.group(1) if m.groups() else m.group(0))
|
||||
else:
|
||||
return None
|
||||
except (ValueError, re.error):
|
||||
return None
|
||||
return value * scale
|
||||
|
||||
|
||||
def hexs(data):
|
||||
"""bytes -> 'AA BB CC' 大写 hex, 日志统一格式"""
|
||||
return bytes(data).hex(' ').upper()
|
||||
|
||||
|
||||
def clean_text(s):
|
||||
"""控制字符 -> '·': 二进制按 ASCII 解出的 NUL 等会污染日志行,
|
||||
且 Windows 剪贴板遇 NUL 直接截断复制内容(DLPilot 同源教训)"""
|
||||
return ''.join(c if ord(c) >= 0x20 and ord(c) != 0x7F else '·' for c in s)
|
||||
@@ -0,0 +1,157 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
创建/更新 Gitea Release 并上传发布 zip(纯标准库, 无需安装依赖)
|
||||
================================================================
|
||||
用法:
|
||||
python publish_gitea.py SerialMate-v0.1.0-win64.zip
|
||||
python publish_gitea.py <zip> --notes-file release/notes-v0.1.0.md
|
||||
python publish_gitea.py <zip> --tag SerialMate-v0.1.0 --replace
|
||||
|
||||
行为:
|
||||
- tag 与版本默认取 zip 文件名(SerialMate-vX.Y.Z-win64.zip → SerialMate-vX.Y.Z)
|
||||
- release 不存在则创建(tag 不存在时 Gitea 在默认分支头自动建 tag);
|
||||
已存在则复用, 仅上传/更新资产
|
||||
- release 上已有同名资产时: 默认跳过, --replace 删旧再传
|
||||
- API token: --token 参数或环境变量 GITEA_TOKEN(需该仓库写权限)
|
||||
- 本实例 TLS 间歇抽风: 已内置连接级重试, 实际发布请加 --insecure
|
||||
"""
|
||||
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import ssl
|
||||
import subprocess
|
||||
import sys
|
||||
import time
|
||||
import urllib.error
|
||||
import urllib.request
|
||||
import uuid
|
||||
|
||||
DEFAULT_NOTES = """## SerialMate {version}
|
||||
|
||||
RS485/串口调试助手(LT8619C 调试工具集配套): 串口收发 + 协议包解析,
|
||||
帧格式(包头/板ID/LEN/CRC 算法与覆盖范围)全可定制, 默认与 DLPilot 光机
|
||||
RS485 协议一致; payload 支持字符串/HEX 显示、4 通道曲线绘制, 发送框输入
|
||||
payload 自动包装组帧(多条用 / 分隔), 也可 HEX 直发与周期发送。
|
||||
|
||||
### 安装
|
||||
下载 `SerialMate-v{version}-win64.zip`, 解压后双击 `SerialMate.exe`
|
||||
(Windows 10/11 x64, 免安装; 串口功能需系统可访问串口, 程序自带 pyserial)。
|
||||
|
||||
### 包内容
|
||||
- `SerialMate.exe` — 主程序
|
||||
- `README.md` — 完整使用说明
|
||||
"""
|
||||
|
||||
|
||||
def git_remote_info():
|
||||
"""从 origin 远程地址解析 API base 与 owner/repo(ssh 端口不影响 https API)"""
|
||||
url = subprocess.check_output(['git', 'remote', 'get-url', 'origin']).decode().strip()
|
||||
m = re.match(r'(?:ssh://git@|git@)([\w.-]+)(?::\d+)?[:/]([\w.-]+)/([\w.-]+?)(?:\.git)?$', url)
|
||||
if not m:
|
||||
sys.exit(f'无法从 origin 解析 Gitea 地址: {url}')
|
||||
host, owner, repo = m.groups()
|
||||
return f'https://{host}', owner, repo
|
||||
|
||||
|
||||
class Api:
|
||||
def __init__(self, base, owner, repo, token, insecure):
|
||||
self.api = f'{base}/api/v1/repos/{owner}/{repo}'
|
||||
self.headers = {'Authorization': f'token {token}'}
|
||||
self.ctx = ssl._create_unverified_context() if insecure else None
|
||||
|
||||
def request(self, method, path, data=None, headers=None, retries=4):
|
||||
"""发请求; 实例 TLS 间歇性抽风(SSL UNEXPECTED_EOF), 连接级错误自动重试"""
|
||||
last = None
|
||||
for attempt in range(retries):
|
||||
req = urllib.request.Request(self.api + path, data=data, method=method,
|
||||
headers={**self.headers, **(headers or {})})
|
||||
try:
|
||||
with urllib.request.urlopen(req, context=self.ctx) as resp:
|
||||
body = resp.read()
|
||||
return resp.status, json.loads(body) if body else None
|
||||
except urllib.error.HTTPError as e:
|
||||
return e.code, json.loads(e.read() or b'{}')
|
||||
except (urllib.error.URLError, ssl.SSLError, OSError) as e:
|
||||
last = e
|
||||
time.sleep(1.0 + attempt)
|
||||
raise RuntimeError(f'Gitea 请求连续 {retries} 次失败: {last}')
|
||||
|
||||
def get_json(self, path):
|
||||
status, data = self.request('GET', path)
|
||||
return data if status == 200 else None
|
||||
|
||||
def upload_asset(self, release_id, filepath, replace):
|
||||
name = os.path.basename(filepath)
|
||||
status, rel = self.request('GET', f'/releases/{release_id}')
|
||||
if status != 200:
|
||||
sys.exit(f'读取 release {release_id} 失败: {status} {rel}')
|
||||
# Gitea 版本差异: assets 可能是 {items:[...]} 或纯数组
|
||||
assets = rel.get('assets') or []
|
||||
if isinstance(assets, dict):
|
||||
assets = assets.get('items', [])
|
||||
for asset in assets:
|
||||
if asset['name'] == name:
|
||||
if not replace:
|
||||
print(f'资产 {name} 已存在, 跳过(覆盖请加 --replace)')
|
||||
return
|
||||
self.request('DELETE', f"/releases/{release_id}/assets/{asset['id']}")
|
||||
print(f'已删除旧资产 {name}')
|
||||
boundary = uuid.uuid4().hex
|
||||
payload = open(filepath, 'rb').read()
|
||||
body = (f'--{boundary}\r\n'
|
||||
f'Content-Disposition: form-data; name="attachment"; filename="{name}"\r\n'
|
||||
f'Content-Type: application/octet-stream\r\n\r\n').encode() + payload + \
|
||||
f'\r\n--{boundary}--\r\n'.encode()
|
||||
status, data = self.request(
|
||||
'POST', f'/releases/{release_id}/assets?name={name}', body,
|
||||
{'Content-Type': f'multipart/form-data; boundary={boundary}'})
|
||||
if status != 201:
|
||||
sys.exit(f'上传资产失败: {status} {data}')
|
||||
print(f'已上传资产: {name} ({len(payload) / 1024 / 1024:.1f} MB)')
|
||||
|
||||
|
||||
def main():
|
||||
ap = argparse.ArgumentParser()
|
||||
ap.add_argument('zipfile_path', help='发布 zip(release/ 下)')
|
||||
ap.add_argument('--tag', help='release 标签, 默认取 zip 文件名去掉 -win64.zip')
|
||||
ap.add_argument('--notes-file', help='release 说明 markdown 文件, 默认用内置模板')
|
||||
ap.add_argument('--token', default=os.environ.get('GITEA_TOKEN'), help='API token')
|
||||
ap.add_argument('--replace', action='store_true', help='覆盖已存在的同名资产')
|
||||
ap.add_argument('--insecure', action='store_true', help='跳过 TLS 证书校验(自签证书)')
|
||||
args = ap.parse_args()
|
||||
|
||||
if not os.path.exists(args.zipfile_path):
|
||||
sys.exit(f'找不到 {args.zipfile_path}')
|
||||
if not args.token:
|
||||
sys.exit('缺少 API token: 传 --token 或设环境变量 GITEA_TOKEN')
|
||||
|
||||
tag = args.tag or re.sub(r'-win64\.zip$', '', os.path.basename(args.zipfile_path))
|
||||
version = tag.removeprefix('SerialMate-v')
|
||||
notes = open(args.notes_file, encoding='utf-8').read() if args.notes_file \
|
||||
else DEFAULT_NOTES.format(version=version)
|
||||
|
||||
base, owner, repo = git_remote_info()
|
||||
api = Api(base, owner, repo, args.token, args.insecure)
|
||||
print(f'目标: {base}/{owner}/{repo} tag={tag}')
|
||||
|
||||
rel = api.get_json(f'/releases/tags/{tag}')
|
||||
if rel:
|
||||
print(f'release 已存在(id={rel["id"]}), 复用')
|
||||
else:
|
||||
status, rel = api.request('POST', '/releases', json.dumps({
|
||||
'tag_name': tag,
|
||||
'name': f'SerialMate v{version}',
|
||||
'body': notes,
|
||||
}).encode(), {'Content-Type': 'application/json'})
|
||||
if status != 201:
|
||||
sys.exit(f'创建 release 失败: {status} {rel}')
|
||||
print(f'release 已创建(id={rel["id"]})')
|
||||
api.upload_asset(rel['id'], args.zipfile_path, args.replace)
|
||||
print(f'完成: {rel.get("html_url", "") or f"{base}/{owner}/{repo}/releases/tag/{tag}"}')
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
@@ -0,0 +1,228 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""protocol.py 协议自检(无硬件): DLPilot 实测帧向量回归 + CRC 标准校验值 + 解析同步
|
||||
|
||||
用法: python selftest.py (全部通过退出码 0)
|
||||
"""
|
||||
import random
|
||||
import sys
|
||||
|
||||
import protocol as d
|
||||
|
||||
fails = []
|
||||
|
||||
|
||||
def check(name, got, want):
|
||||
ok = got == want
|
||||
print(('PASS' if ok else 'FAIL'), name, '->', got, '' if ok else f'(期望 {want})')
|
||||
if not ok:
|
||||
fails.append(name)
|
||||
|
||||
|
||||
def check_close(name, got, want):
|
||||
ok = isinstance(got, float) and abs(got - want) < 1e-6
|
||||
print(('PASS' if ok else 'FAIL'), name, '->', got, '' if ok else f'(期望 {want})')
|
||||
if not ok:
|
||||
fails.append(name)
|
||||
|
||||
|
||||
cfg = d.ProtoConfig() # 默认即 DLPilot: D5/B5/01/SUM8/不含包头
|
||||
|
||||
# 1) 帧构造: DLPilot selftest_rs485.py 的实测向量(上游 protocols.md)
|
||||
for cmd, want in (
|
||||
('M730S0T2000', 'D5 01 0B 4D 37 33 30 53 30 54 32 30 30 30 8C'),
|
||||
('M303', 'D5 01 04 4D 33 30 33 E8'),
|
||||
('M304', 'D5 01 04 4D 33 30 34 E9'),
|
||||
('M305', 'D5 01 04 4D 33 30 35 EA'),
|
||||
):
|
||||
check(f'build_frame({cmd})', cfg.build_frame(cmd.encode('ascii')).hex(' ').upper(), want)
|
||||
|
||||
# 2) CRC 算法实现对照公开标准校验值 check("123456789")
|
||||
check('crc8 check', d._crc8(b'123456789'), 0xF4)
|
||||
check('crc16_modbus check', d._crc16_modbus(b'123456789'), 0x4B37)
|
||||
check('crc16_xmodem check', d._crc16_xmodem(b'123456789'), 0x31C3)
|
||||
check('crc16_ccitt check', d._crc16_ccitt(b'123456789'), 0x29B1)
|
||||
|
||||
# 3) CRC 覆盖范围(手算向量: 包头 5A 板ID 11, payload 01 02)
|
||||
for scope, want in (('payload_only', '5A 11 02 01 02 03'),
|
||||
('no_header', '5A 11 02 01 02 16'),
|
||||
('with_header', '5A 11 02 01 02 70')):
|
||||
c = d.ProtoConfig(tx_hdr=0x5A, board=0x11, crc_scope=scope)
|
||||
check(f'coverage {scope}', c.build_frame(b'\x01\x02').hex(' ').upper(), want)
|
||||
|
||||
# 4) CRC16 帧往返 + 坏帧拒绝(组帧/解析同头才能回路, 收发方向包头本就允许不同)
|
||||
c16 = d.ProtoConfig(tx_hdr=0x55, rx_hdr=0x55, crc_algo='CRC16_MODBUS', crc_scope='with_header')
|
||||
f = c16.build_frame(b'ABC')
|
||||
check('crc16 frame len', len(f), 3 + 3 + 2)
|
||||
check('crc16 verify', c16.verify_frame(f), True)
|
||||
bad = bytearray(f)
|
||||
bad[4] ^= 0xFF
|
||||
check('crc16 bad rejected', c16.verify_frame(bytes(bad)), False)
|
||||
frames = d.FrameParser(c16).feed(f)
|
||||
check('crc16 parse payload', (frames[0].payload, frames[0].code) if frames else None, (b'ABC', 0x01))
|
||||
|
||||
# 5) LEN=0 空载荷帧(心跳类): D5 01 00 + sum(01)=01
|
||||
check('empty payload frame', cfg.build_frame(b'').hex(' ').upper(), 'D5 01 00 01')
|
||||
loop = d.ProtoConfig(tx_hdr=0xB5) # tx/rx 同头以便回路
|
||||
check('empty payload parse', d.FrameParser(loop).feed(loop.build_frame(b''))[0].payload, b'')
|
||||
|
||||
# 6) 超长 payload 拒绝
|
||||
try:
|
||||
cfg.build_frame(b'\x00' * 256)
|
||||
fails.append('oversize-not-rejected')
|
||||
except ValueError:
|
||||
print('PASS 超长 payload 拒绝')
|
||||
|
||||
# 7) 增量解析: ok 应答逐字节喂入(拆到最碎) + 前导噪声
|
||||
good = bytes.fromhex('B5 F0 02 6F 6B CC')
|
||||
p = d.FrameParser(cfg)
|
||||
out = []
|
||||
for i in range(len(good)):
|
||||
out += p.feed(good[i:i + 1])
|
||||
check('byte-wise feed frames', len(out), 1)
|
||||
check('code', out[0].code, 0xF0)
|
||||
check('payload', out[0].payload, b'ok')
|
||||
check('raw', d.hexs(out[0].raw), 'B5 F0 02 6F 6B CC')
|
||||
out = d.FrameParser(cfg).feed(b'\x01\x02' + good)
|
||||
check('noise+frame count', len(out), 1)
|
||||
|
||||
# 8) CRC 坏帧被丢弃后继续同步到下一帧
|
||||
bad = bytearray(good)
|
||||
bad[-1] ^= 0xFF
|
||||
frames = d.FrameParser(cfg).feed(bytes(bad) + good)
|
||||
check('bad-crc then good', len(frames), 1)
|
||||
check('recovered code', frames[0].code, 0xF0)
|
||||
|
||||
# 9) 伪帧头与帧头字节入载荷
|
||||
# 9a 小 LEN 伪帧头(B5 AA 01 55,CRC 应为 00 而实为 01)失败后逐字节重同步到真帧
|
||||
frames = d.FrameParser(cfg).feed(b'\xB5\xAA\x01\x55\x01' + good)
|
||||
check('pseudo-header resync', len(frames), 1)
|
||||
check('resync payload', frames[0].payload, b'ok')
|
||||
# 9b payload 内含 0xB5(帧头字节)的合法帧: B5 F0 02 B5 F0 + sum(F0 02 B5 F0)=0x297→97
|
||||
frames = d.FrameParser(cfg).feed(bytes.fromhex('B5 F0 02 B5 F0 97') + good)
|
||||
check('rx-hdr-in-payload', len(frames), 2)
|
||||
check('rx-hdr-in-payload payload', frames[0].payload, b'\xB5\xF0')
|
||||
|
||||
# 10) 自定义包头/板ID 往返(非 DLPilot 值)
|
||||
cx = d.ProtoConfig(tx_hdr=0xC3, rx_hdr=0xC3, board=0x7A)
|
||||
frames = d.FrameParser(cx).feed(cx.build_frame(b'PING'))
|
||||
check('custom hdr frame count', len(frames), 1)
|
||||
check('custom hdr code', frames[0].code, 0x7A)
|
||||
check('custom hdr payload', frames[0].payload, b'PING')
|
||||
|
||||
# 11) 数值提取(曲线通道)
|
||||
check_close('bin u16be', d.extract_value(bytes.fromhex('00 34'), 'bin', fmt='u16be'), 52.0)
|
||||
check_close('bin s16le 负值', d.extract_value(bytes.fromhex('FE FF'), 'bin', fmt='s16le'), -2.0)
|
||||
check_close('bin f32be', d.extract_value(bytes.fromhex('3F 80 00 00'), 'bin', fmt='f32be'), 1.0)
|
||||
check_close('bin offset', d.extract_value(bytes.fromhex('AA 00 34'), 'bin', offset=1, fmt='u16be'), 52.0)
|
||||
check_close('num TL:246', d.extract_value(b'okTL:246', 'num'), 246.0)
|
||||
check_close('num scale 0.1', d.extract_value(b'okTL:246', 'num', scale=0.1), 24.6)
|
||||
check_close('num 第3个', d.extract_value(b'okR12G34B56', 'num', index=3), 56.0)
|
||||
check_close('re 捕获组', d.extract_value(b'okTL:246', 're'), 246.0)
|
||||
check('num 缺数字', d.extract_value(b'ok', 'num'), None)
|
||||
check('bin 越界', d.extract_value(b'\x01', 'bin', offset=2), None)
|
||||
check('re 非法表达式', d.extract_value(b'x', 're', pattern='('), None)
|
||||
check('未知模式', d.extract_value(b'x', 'bogus'), None)
|
||||
|
||||
# 12) 随机往返模糊: 三种算法 × 三种覆盖范围, 整喂/乱拆两种方式
|
||||
rng = random.Random(20260927)
|
||||
for algo in ('SUM8', 'CRC8', 'CRC16_MODBUS'):
|
||||
for scope in d.CRC_SCOPES:
|
||||
cf = d.ProtoConfig(tx_hdr=0xB5, crc_algo=algo, crc_scope=scope) # tx=rx 回路
|
||||
for _ in range(20):
|
||||
pl = bytes(rng.randrange(256) for _ in range(rng.randrange(41)))
|
||||
frame = cf.build_frame(pl)
|
||||
fp = d.FrameParser(cf)
|
||||
if rng.random() < 0.5:
|
||||
got = fp.feed(frame)
|
||||
else:
|
||||
cut = rng.randrange(len(frame) + 1)
|
||||
got = fp.feed(frame[:cut]) + fp.feed(frame[cut:])
|
||||
ok = len(got) == 1 and got[0].payload == pl and got[0].raw == frame
|
||||
if not ok:
|
||||
check(f'fuzz {algo}/{scope}', ok, True)
|
||||
break
|
||||
print(f'模糊往返 3 算法 × 3 覆盖 × 20 帧: {"PASS" if not fails else "见上"}')
|
||||
|
||||
# 13) 日志行安全: clean_text 把控制字符换成 '·'
|
||||
check('clean_text NUL', d.clean_text('a\x00b\x7f'), 'a·b·')
|
||||
|
||||
# 14) 帧构成定制(发送/接收同一布局, 收发方向仅包头值不同; 回路用例 rx_hdr=D5
|
||||
# 以便解析器接受 TX 包头, 字面量同步头布局则与包头值无关)
|
||||
# 14a 双字节字面量同步头 + 无板ID: AA 55 LEN payload CRC
|
||||
cl = d.FrameLayout.parse('AA 55 LEN PAYLOAD CRC')
|
||||
c = d.ProtoConfig(layout=cl)
|
||||
check('layout 字面量组帧', c.build_frame(b'\x01\x02').hex(' ').upper(), 'AA 55 02 01 02 5A')
|
||||
frames = d.FrameParser(c).feed(c.build_frame(b'\x01\x02'))
|
||||
check('layout 字面量解析', (len(frames), frames[0].code, frames[0].payload) if frames else None,
|
||||
(1, None, b'\x01\x02'))
|
||||
|
||||
# 14b 自定义字段顺序: HDR LEN ID PAYLOAD CRC(板ID 在 LEN 后)
|
||||
c = d.ProtoConfig(rx_hdr=0xD5, board=0x2A,
|
||||
layout=d.FrameLayout.parse('HDR LEN ID PAYLOAD CRC'))
|
||||
check('layout 换序组帧', c.build_frame(b'OK').hex(' ').upper(), 'D5 02 2A 4F 4B C6')
|
||||
frames = d.FrameParser(c).feed(c.build_frame(b'OK'))
|
||||
check('layout 换序解析', (frames[0].code, frames[0].payload) if frames else None, (0x2A, b'OK'))
|
||||
|
||||
# 14c 无板ID布局: HDR LEN PAYLOAD CRC, Frame.code 应为 None
|
||||
c = d.ProtoConfig(rx_hdr=0xD5, layout=d.FrameLayout.parse('HDR LEN PAYLOAD CRC'))
|
||||
check('layout 无ID组帧', c.build_frame(b'M1').hex(' ').upper(), 'D5 02 4D 31 80')
|
||||
frames = d.FrameParser(c).feed(c.build_frame(b'M1'))
|
||||
check('layout 无ID解析', (frames[0].code, frames[0].payload) if frames else None,
|
||||
(None, b'M1'))
|
||||
|
||||
# 14d LEN 口径: body(payload+CRC) / total(整帧) —— M303 载荷 4 字节
|
||||
c = d.ProtoConfig(rx_hdr=0xD5, len_sem='body')
|
||||
check('LEN 口径 body', c.build_frame(b'M303').hex(' ').upper(), 'D5 01 05 4D 33 30 33 E9')
|
||||
frames = d.FrameParser(c).feed(c.build_frame(b'M303'))
|
||||
check('LEN 口径 body 解析', frames[0].payload if frames else None, b'M303')
|
||||
c = d.ProtoConfig(rx_hdr=0xD5, len_sem='total')
|
||||
check('LEN 口径 total', c.build_frame(b'M303').hex(' ').upper(), 'D5 01 08 4D 33 30 33 EC')
|
||||
frames = d.FrameParser(c).feed(c.build_frame(b'M303'))
|
||||
check('LEN 口径 total 解析', frames[0].payload if frames else None, b'M303')
|
||||
|
||||
# 14e 仅 payload 覆盖 + 板ID 在 payload 后: 'HDR LEN PAYLOAD ID CRC'
|
||||
c = d.ProtoConfig(rx_hdr=0xD5, board=0x7B, crc_scope='payload_only',
|
||||
layout=d.FrameLayout.parse('HDR LEN PAYLOAD ID CRC'))
|
||||
check('layout ID在payload后', c.build_frame(b'\x01').hex(' ').upper(), 'D5 01 01 7B 01')
|
||||
frames = d.FrameParser(c).feed(c.build_frame(b'\x01'))
|
||||
check('layout ID在payload后解析', (frames[0].code, frames[0].payload) if frames else None,
|
||||
(0x7B, b'\x01'))
|
||||
|
||||
# 14f 非法帧构成一律拒绝
|
||||
for bad in ('HDR PAYLOAD CRC', # 缺 LEN
|
||||
'HDR LEN CRC PAYLOAD', # CRC 不在末尾
|
||||
'LEN PAYLOAD CRC', # 无同步头
|
||||
'HDR ID ID LEN PAYLOAD CRC', # ID 重复
|
||||
'HDR ID LEN FOO CRC', # 未知令牌
|
||||
'', # 空
|
||||
'HDR ID LEN PAYLOAD'): # 缺 CRC
|
||||
try:
|
||||
d.FrameLayout.parse(bad)
|
||||
fails.append(f'layout-not-rejected:{bad}')
|
||||
print('FAIL 帧构成未拒绝 ->', bad)
|
||||
except ValueError:
|
||||
pass
|
||||
print('非法帧构成拒绝: PASS')
|
||||
check('大小写/逗号容错', d.FrameLayout.parse('hdr, id, len, payload, crc').tokens,
|
||||
d.FrameLayout.parse(d.DEFAULT_LAYOUT).tokens)
|
||||
|
||||
# 15) 自定义布局模糊往返(乱拆喂入; 有 HDR 令牌的布局回路需 rx_hdr=tx_hdr)
|
||||
rng2 = random.Random(9527)
|
||||
for spec in ('AA 55 LEN PAYLOAD CRC', 'HDR LEN ID PAYLOAD CRC',
|
||||
'HDR LEN PAYLOAD ID CRC'):
|
||||
cf = d.ProtoConfig(rx_hdr=0xD5, layout=d.FrameLayout.parse(spec))
|
||||
for _ in range(10):
|
||||
pl = bytes(rng2.randrange(256) for _ in range(rng2.randrange(41)))
|
||||
frame = cf.build_frame(pl)
|
||||
fp = d.FrameParser(cf)
|
||||
cut = rng2.randrange(len(frame) + 1)
|
||||
got = fp.feed(frame[:cut]) + fp.feed(frame[cut:])
|
||||
ok = len(got) == 1 and got[0].payload == pl and got[0].raw == frame
|
||||
if not ok:
|
||||
check(f'layout fuzz {spec}', ok, True)
|
||||
break
|
||||
print(f'布局模糊往返 3 布局 × 10 帧: {"PASS" if not fails else "见上"}')
|
||||
|
||||
print('RESULT:', 'FAIL:' + ','.join(fails) if fails else 'ALL PASS')
|
||||
sys.exit(1 if fails else 0)
|
||||
@@ -0,0 +1,263 @@
|
||||
"""GUI 功能自检(offscreen 无窗口): 组帧预览/TX回显/帧日志/通道提取/显示切换/
|
||||
未连接丢弃/配置往返
|
||||
====================================================================
|
||||
不依赖硬件与串口, 直接驱动 Window 的事件处理函数; 改 main.py 后建议重跑。
|
||||
|
||||
用法: python selftest_gui.py (全部通过退出码 0)
|
||||
"""
|
||||
import os
|
||||
import re
|
||||
import sys
|
||||
|
||||
os.environ['QT_QPA_PLATFORM'] = 'offscreen'
|
||||
sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
|
||||
|
||||
from PySide6.QtWidgets import QApplication
|
||||
|
||||
import config
|
||||
import main as m
|
||||
import protocol as d
|
||||
from plot import fmt_val
|
||||
|
||||
fails = []
|
||||
|
||||
|
||||
def check(name, got, want):
|
||||
ok = got == want
|
||||
print(('PASS' if ok else 'FAIL'), name, '->', repr(got)[:120],
|
||||
'' if ok else f'(期望 {want!r})')
|
||||
if not ok:
|
||||
fails.append(name)
|
||||
|
||||
|
||||
# 0) 数值显示格式: 普通小数千分位(科学计数只留给 10 亿以上)
|
||||
check('fmt_val 千分位', fmt_val(28210029), '28,210,029')
|
||||
check('fmt_val 小数', fmt_val(24.6), '24.6')
|
||||
check('fmt_val 负小数', fmt_val(-0.25), '-0.25')
|
||||
check('fmt_val 零', fmt_val(0), '0')
|
||||
|
||||
app = QApplication(sys.argv)
|
||||
win = m.Window()
|
||||
win.show() # offscreen 显示, isVisible 类断言前提
|
||||
check('倍率/偏移/序号框宽度(防数值裁切回归)',
|
||||
win._ch_ui[0]['scale'].width() >= 130
|
||||
and win._ch_ui[0]['off'].width() >= 110
|
||||
and win._ch_ui[0]['idx'].width() >= 110, True)
|
||||
win._apply_minimum_size()
|
||||
check('窗口最小高度(防曲线卡叠压)', win.minimumHeight() >= 800, True)
|
||||
|
||||
# 0b) 曲线时间窗换算(纯计算; 窗口不向数据收敛——选 5min 就显示 5min 宽的轴)
|
||||
p = win.plot
|
||||
p.set_view(10)
|
||||
p.set_offset(0)
|
||||
check('时间窗跟随右缘', p.visible_domain(0, 100) == (90.0, 100.0), True)
|
||||
p.set_offset(30)
|
||||
check('时间窗滞后回看', p.visible_domain(0, 100) == (60.0, 70.0), True)
|
||||
p.set_offset(90)
|
||||
check('时间窗滑到最旧', p.visible_domain(0, 100) == (0.0, 10.0), True)
|
||||
p.set_offset(500)
|
||||
check('滞后超史为空窗(保宽)', p.visible_domain(0, 100) == (-410.0, -400.0), True)
|
||||
p.set_view(300)
|
||||
p.set_offset(0)
|
||||
check('数据不足窗宽不收敛', p.visible_domain(0, 23) == (-277.0, 23.0), True)
|
||||
p.set_view(None)
|
||||
p.set_offset(0)
|
||||
check('跟随全部', p.visible_domain(0, 100) == (0.0, 100.0), True)
|
||||
|
||||
# 0c) 悬停读值: 最近采样命中/容差外未命中
|
||||
import time as _time
|
||||
base = _time.perf_counter()
|
||||
p._times[0].clear()
|
||||
p._vals[0].clear()
|
||||
p._names[0] = '甲'
|
||||
for tt, vv in ((0.0, 10.0), (1.0, 20.0), (2.0, 30.0)):
|
||||
p._times[0].append(base + tt)
|
||||
p._vals[0].append(vv)
|
||||
check('悬停命中最近点', p._nearest(0, base + 1.9, 0.2) == ('甲', 30.0), True)
|
||||
check('悬停容差外未命中', p._nearest(0, base + 1.4, 0.2) is None, True)
|
||||
lo, hi = p.auto_yrange()
|
||||
check('自动Y量程', abs(lo - 8.4) < 1e-9 and abs(hi - 31.6) < 1e-9, True)
|
||||
from PySide6.QtCore import QPoint
|
||||
p.resize(600, 300) # 未走布局, 手动给几何
|
||||
lines = p._hover_lines_at(QPoint(320, 150)) # x=绘图区正中 → t=base+1.0
|
||||
check('悬停框内容(位置固定也随数据刷新)',
|
||||
lines[:2] == [f'T = {base + 1.0:.2f}s', '甲 = 20'], True)
|
||||
|
||||
# 0d) 暂停渲染 vs 暂停采集: 冻结期间继续收数, 解冻后数据都在
|
||||
p.set_frozen(True)
|
||||
n0 = len(p._times[0])
|
||||
p.add(0, 42.0)
|
||||
check('冻结期间继续收数', p.is_frozen() and len(p._times[0]) == n0 + 1, True)
|
||||
p.set_frozen(False)
|
||||
p.set_paused(True)
|
||||
n1 = len(p._times[0])
|
||||
p.add(0, 43.0)
|
||||
check('暂停期间丢弃', p.is_paused() and len(p._times[0]) == n1, True)
|
||||
p.set_paused(False)
|
||||
|
||||
# 0e) 时间戳: 纯格式化函数, 传入到达时刻得确定字符串, 不传兜底当前时刻
|
||||
t_fix = 1759474800 + 0.456
|
||||
check('时间戳格式化(到达时刻)', m._timestamp(t_fix),
|
||||
_time.strftime('%H:%M:%S', _time.localtime(t_fix)) + '.456')
|
||||
check('时间戳格式化(现在兜底)',
|
||||
re.match(r'\d{2}:\d{2}:\d{2}\.\d{3}$', m._timestamp()) is not None, True)
|
||||
|
||||
# 1) 组帧预览: 多条 '/' 分隔
|
||||
win.ed_tx.setText('M1/M731S0T1000')
|
||||
check('多条预览', win.lb_preview.text(),
|
||||
'D5 01 02 4D 31 81 | D5 01 0B 4D 37 33 31 53 30 54 31 30 30 30 8C')
|
||||
win.combo_tx_mode.setCurrentIndex(1)
|
||||
win.ed_tx.setText('D5 01 02 4D 31 81')
|
||||
check('HEX预览', win.lb_preview.text(), '→ D5 01 02 4D 31 81')
|
||||
win.combo_tx_mode.setCurrentIndex(0)
|
||||
win.ed_tx.setText('M1')
|
||||
|
||||
# 1b) 帧构成定制: 无板ID布局 + LEN 口径切换 + 非法输入提示
|
||||
win.ed_layout.setText('HDR LEN PAYLOAD CRC')
|
||||
check('帧构成无ID预览', win.lb_preview.text(), 'D5 02 4D 31 80')
|
||||
win.combo_len_sem.setCurrentIndex(1) # 到帧尾(payload+CRC)
|
||||
check('帧构成LEN口径预览', win.lb_preview.text(), 'D5 03 4D 31 81')
|
||||
win.combo_len_sem.setCurrentIndex(0)
|
||||
win.ed_layout.setText('HDR LEN') # 缺 PAYLOAD/CRC -> 拒绝
|
||||
check('帧构成非法提示', win.lb_preview.text().startswith('⚠'), True)
|
||||
check('帧构成非法详情', 'PAYLOAD 必须恰好出现一次' in win.lb_proto.text(), True)
|
||||
win.ed_layout.setText(d.DEFAULT_LAYOUT)
|
||||
check('帧构成还原预览', win.lb_preview.text(), 'D5 01 02 4D 31 81')
|
||||
|
||||
# 2) TX 回显行(直接驱动处理函数, 断言前 flush 批量日志缓冲)
|
||||
cfg = win._proto_from_ui()
|
||||
win._on_tx('M1', cfg.build_frame(b'M1'))
|
||||
win._flush_rx()
|
||||
check('TX日志行', 'M1 [D5 01 02 4D 31 81]' in win.text_rx.toPlainText(), True)
|
||||
|
||||
# 3) 帧事件: 日志 + 通道提取(文本数字×0.1)
|
||||
win.combo_display.setCurrentIndex(0)
|
||||
fr = d.FrameParser(d.ProtoConfig()).feed(
|
||||
bytes.fromhex('B5 F0 08 6F 6B 54 4C 3A 32 34 36 48'))[0]
|
||||
win._ch_ui[0]['chk'].setChecked(True)
|
||||
win._ch_ui[0]['mode'].setCurrentIndex(1) # 文本数字
|
||||
win._ch_ui[0]['idx'].setValue(1)
|
||||
win._ch_ui[0]['scale'].setValue(0.1)
|
||||
win._on_frame(fr)
|
||||
win._flush_rx()
|
||||
last = win.text_rx.toPlainText().splitlines()[-1]
|
||||
check('帧日志含 TYPE 名', 'B=0xF0 成功' in last and 'LEN=8' in last
|
||||
and 'okTL:246' in last, True)
|
||||
check('通道最新值', win._ch_ui[0]['val'].text(), '24.6')
|
||||
# 时间戳用 link 后台线程打的到达时刻, 而非 GUI 消费时刻
|
||||
ft = _time.time() - 3.456
|
||||
win._on_frame(fr, ft)
|
||||
win._flush_rx()
|
||||
check('帧日志用到达时刻', m._timestamp(ft)
|
||||
in win.text_rx.toPlainText().splitlines()[-1], True)
|
||||
|
||||
# 4) HEX 显示切换 + 原始帧
|
||||
win.combo_display.setCurrentIndex(1)
|
||||
win._on_frame(fr)
|
||||
win._flush_rx()
|
||||
last = win.text_rx.toPlainText().splitlines()[-1]
|
||||
check('HEX显示+原始帧', '6F 6B 54 4C 3A 32 34 36' in last
|
||||
and '[B5 F0 08 6F 6B 54 4C 3A 32 34 36 48]' in last, True)
|
||||
|
||||
# 5) 透传行
|
||||
win.combo_display.setCurrentIndex(1)
|
||||
win._on_raw(b'\x11\x22')
|
||||
win._flush_rx()
|
||||
check('透传HEX行', win.text_rx.toPlainText().splitlines()[-1].endswith('11 22'), True)
|
||||
|
||||
# 6) 未连接发送丢弃
|
||||
win._send()
|
||||
win._drain_events()
|
||||
check('未连接发送提示', '未连接串口, 命令被丢弃' in win.text_rx.toPlainText(), True)
|
||||
|
||||
# 6b) 通道配置缓存: 帧路径读 _ch_cfg, 用户改配置时重建
|
||||
win._ch_ui[1]['chk'].setChecked(True)
|
||||
win._ch_ui[1]['name'].setText('乙')
|
||||
check('通道缓存随配置重建', win._ch_cfg[1]['enabled']
|
||||
and win._ch_cfg[1]['name'] == '乙', True)
|
||||
win._ch_ui[1]['chk'].setChecked(False)
|
||||
check('通道缓存关闭同步', not win._ch_cfg[1]['enabled'], True)
|
||||
|
||||
# 6c) 积压折叠: 队列积压超阈值时帧日志折叠为计数摘要(带首尾到达时刻), 曲线照常入库
|
||||
rx_n0, plot_n0 = win._rx_n, len(p._vals[0])
|
||||
now = _time.time()
|
||||
for k in range(250): # 100ms 间隔的到达时刻, 模拟高频上报
|
||||
win.events.put(('frame', fr, now - (250 - k) / 10.0))
|
||||
win._drain_events()
|
||||
log = win.text_rx.toPlainText()
|
||||
check('积压折叠摘要行', '折叠 250 帧' in log, True)
|
||||
check('折叠显示到达跨度', m._timestamp(now - 25.0) in log
|
||||
and m._timestamp(now - 0.1) in log, True)
|
||||
check('折叠保曲线', len(p._vals[0]) == plot_n0 + 250, True)
|
||||
check('折叠计数器照常', win._rx_n == rx_n0 + 250, True)
|
||||
check('折叠摘要含帧描述', 'B=0xF0 成功 ×250' in log, True)
|
||||
|
||||
# 7) 配置往返
|
||||
store = win._store_from_ui()
|
||||
check('配置 proto', (store['proto']['tx_hdr'], store['proto']['crc_algo']),
|
||||
('D5', 'SUM8'))
|
||||
check('配置帧构成', (store['proto']['layout'], store['proto']['len_sem']),
|
||||
(d.DEFAULT_LAYOUT, 'payload'))
|
||||
check('配置通道1', (store['channels'][0]['enabled'], store['channels'][0]['scale']),
|
||||
(True, 0.1))
|
||||
|
||||
# 8) 板型档案: 保存/切换应用协议参数/存入命令/清理
|
||||
check('板型档案加载', win.combo_profile.count() >= 1, True)
|
||||
win.ed_board.setText('03')
|
||||
check('存为板型', win._save_profile_as('测试板'), True)
|
||||
names = [win.combo_profile.itemText(i) for i in range(win.combo_profile.count())]
|
||||
check('板型入列', '测试板' in names, True)
|
||||
pidx = names.index('测试板')
|
||||
win.combo_profile.setCurrentIndex(pidx)
|
||||
check('切换板型应用板ID', win.ed_board.text(), '03')
|
||||
win.combo_profile.setCurrentIndex(0)
|
||||
check('切回默认板ID', win.ed_board.text(), '01')
|
||||
win.ed_tx.setText('M1')
|
||||
win._add_command_named('M1', 'M1')
|
||||
check('存入命令去重', any(c[1] == 'M1' for c in win._commands)
|
||||
and len([c for c in win._commands if c[1] == 'M1']) == 1, True)
|
||||
check('预设显示名命令', win.combo_preset.itemText(0) == '握手 · M1', True)
|
||||
# 10) 新建板型(命令预设从空白开始) + 命令预设表编辑器
|
||||
check('新建板型', win._new_profile_named('新建测试板'), True)
|
||||
check('重名新建拒绝', win._new_profile_named('新建测试板'), False)
|
||||
check('新建板型命令为空', win._commands == [], True)
|
||||
dlg = m.ProfileEditDialog(win.profiles[win.combo_profile.currentIndex()])
|
||||
from PySide6.QtWidgets import QTableWidgetItem
|
||||
for r, (n, c) in enumerate((('甲', 'A1'), ('乙', 'B2'), ('丙', 'C3'))):
|
||||
dlg.table._add_row()
|
||||
dlg.table.setItem(r, 1, QTableWidgetItem(n))
|
||||
dlg.table.setItem(r, 2, QTableWidgetItem(c))
|
||||
check('编辑器收集', dlg.commands() == [['甲', 'A1'], ['乙', 'B2'], ['丙', 'C3']],
|
||||
True)
|
||||
dlg.table.move_row(0, 2) # 拖动排序: 首行挪到末尾
|
||||
check('拖动换序', dlg.commands() == [['乙', 'B2'], ['丙', 'C3'], ['甲', 'A1']],
|
||||
True)
|
||||
check('手柄列存在', dlg.table.item(0, 0).text() == '≡', True)
|
||||
dlg.table._add_row() # 重复命令与空命令行均被忽略
|
||||
dlg.table.setItem(3, 1, QTableWidgetItem('重复'))
|
||||
dlg.table.setItem(3, 2, QTableWidgetItem('B2'))
|
||||
check('编辑器去重空行', dlg.commands() == [['乙', 'B2'], ['丙', 'C3'], ['甲', 'A1']],
|
||||
True)
|
||||
# 11) 删除板型: 核函数删除/不存在拒绝/至少保留一个
|
||||
check('删除板型', win._delete_profile('新建测试板'), True)
|
||||
check('删除后不在列', all(p['name'] != '新建测试板' for p in win.profiles), True)
|
||||
check('删除不存在拒绝', win._delete_profile('不存在的板型'), False)
|
||||
# 清理运行态测试板型
|
||||
win.profiles[:] = [p for p in win.profiles if p['name'] != '测试板']
|
||||
config.save_profiles(win.profiles)
|
||||
win._reload_profiles()
|
||||
check('清理测试板型', all(p['name'] != '测试板' for p in win.profiles), True)
|
||||
|
||||
# 9) 曲线弹出/嵌回
|
||||
win._toggle_plot_window()
|
||||
check('曲线弹出', win._plot_win is not None
|
||||
and win.plot.window() is win._plot_win, True)
|
||||
win._toggle_plot_window()
|
||||
check('曲线嵌回', win._plot_win is None and win.plot.parent() is not None, True)
|
||||
win._pop_plot()
|
||||
win._dock_plot()
|
||||
check('弹出后关窗嵌回', win._plot_win is None and win.plot.isVisible(), True)
|
||||
|
||||
win.link.close()
|
||||
print('RESULT:', 'FAIL:' + ','.join(fails) if fails else 'ALL PASS')
|
||||
sys.exit(1 if fails else 0)
|
||||
@@ -0,0 +1,96 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""链路自检(无硬件): pyserial loop:// 虚拟回环验证 组帧→发送→接收→解析→曲线提取
|
||||
====================================================================
|
||||
缺 pyserial 时跳过(退出码 0)。loop:// 回环口写即读, 发出的帧同样回到
|
||||
接收侧, 但 TX 帧头(D5)不是 RX 帧头(B5), 会被解析器当噪声丢弃, 不影响判定。
|
||||
|
||||
用法: python selftest_loop.py (全部通过退出码 0)
|
||||
"""
|
||||
import sys
|
||||
import time
|
||||
|
||||
try:
|
||||
import serial # noqa: F401
|
||||
except ImportError:
|
||||
print('未安装 pyserial, 跳过回环自检')
|
||||
sys.exit(0)
|
||||
|
||||
import protocol as d
|
||||
from link import SerialLink
|
||||
|
||||
fails = []
|
||||
|
||||
|
||||
def check(name, got, want):
|
||||
ok = got == want
|
||||
print(('PASS' if ok else 'FAIL'), name, '->', got, '' if ok else f'(期望 {want})')
|
||||
if not ok:
|
||||
fails.append(name)
|
||||
|
||||
|
||||
def wait_for(pred, timeout=5.0):
|
||||
deadline = time.time() + timeout
|
||||
while time.time() < deadline:
|
||||
if pred():
|
||||
return True
|
||||
time.sleep(0.05)
|
||||
return False
|
||||
|
||||
|
||||
got = {'status': [], 'frames': [], 'tx': [], 'raw': []}
|
||||
cfg = d.ProtoConfig()
|
||||
link = SerialLink(cfg, on_status=lambda s, ts: got['status'].append((s, ts)))
|
||||
link.on_frame = lambda fr, ts: got['frames'].append((fr, ts))
|
||||
link.on_raw = lambda b, ts: got['raw'].append((b, ts))
|
||||
link.on_tx = lambda lb, data, ts: got['tx'].append((lb, data, ts))
|
||||
|
||||
# 1) 打开虚拟回环口
|
||||
link.open('loop://', 115200)
|
||||
check('连接 loop://', wait_for(lambda: got['status'] and
|
||||
got['status'][-1][0].startswith('已连接')), True)
|
||||
check('状态事件携带时刻', isinstance(got['status'][-1][1], float), True)
|
||||
|
||||
# 2) 自动包装发送: TX 回显 + 回环字节
|
||||
payload = 'M731S0T1000'
|
||||
frame = cfg.build_frame(payload.encode('ascii'))
|
||||
link.send_frame(frame, label=payload)
|
||||
check('发送回显', wait_for(lambda: len(got['tx']) >= 1), True)
|
||||
if got['tx']:
|
||||
check('TX label', got['tx'][0][0], payload)
|
||||
check('TX frame', got['tx'][0][1], frame)
|
||||
check('TX 携带写入时刻', isinstance(got['tx'][0][2], float), True)
|
||||
|
||||
# 3) 模拟设备应答: okTL:246(温度 24.6°C) → 解析 + 曲线提取
|
||||
resp = bytes.fromhex('B5 F0 08 6F 6B 54 4C 3A 32 34 36 48') # sum(F0..36)=0x48
|
||||
check('响应帧向量自校验', cfg.verify_frame(resp), True)
|
||||
link.ser.write(resp)
|
||||
check('应答解析', wait_for(lambda: len(got['frames']) >= 1), True)
|
||||
if got['frames']:
|
||||
fr, fts = got['frames'][0]
|
||||
check('帧携带到达时间戳', isinstance(fts, float)
|
||||
and 0 < time.time() - fts < 60, True)
|
||||
check('TYPE 码', fr.code, 0xF0)
|
||||
check('payload', fr.payload, b'okTL:246')
|
||||
v = d.extract_value(fr.payload, 'num', index=1, scale=0.1)
|
||||
check('曲线提取(×0.1)', v is not None and abs(v - 24.6) < 1e-9, True)
|
||||
|
||||
# 4) 透传模式切换: 关解析后收到原始字节
|
||||
link.set_parse(False)
|
||||
raw = bytes([0x11, 0x22, 0xB5, 0x00])
|
||||
link.ser.write(raw)
|
||||
check('透传原始字节', wait_for(lambda: len(got['raw']) >= 1), True)
|
||||
if got['raw']:
|
||||
check('透传内容', got['raw'][0][0], raw)
|
||||
check('透传携带到达时间戳', isinstance(got['raw'][0][1], float), True)
|
||||
|
||||
# 5) 切回解析模式, 缓冲已清空, 正常再收一帧
|
||||
link.set_parse(True)
|
||||
link.ser.write(bytes.fromhex('B5 F0 02 6F 6B CC'))
|
||||
check('切回解析再收帧', wait_for(lambda: len(got['frames']) >= 2), True)
|
||||
|
||||
link.close()
|
||||
check('断开', wait_for(lambda: got['status'] and got['status'][-1][0] == '已断开'), True)
|
||||
|
||||
print('RESULT:', 'FAIL:' + ','.join(fails) if fails else 'ALL PASS')
|
||||
sys.exit(1 if fails else 0)
|
||||
@@ -0,0 +1,129 @@
|
||||
"""Theme persistence and Fluent Widgets integration."""
|
||||
|
||||
import ctypes
|
||||
import os
|
||||
|
||||
from PySide6.QtCore import QObject, QSettings, Qt
|
||||
from PySide6.QtGui import QColor, QPalette
|
||||
from qfluentwidgets import Theme, setTheme, setThemeColor
|
||||
|
||||
# Fluent widgets restyle themselves on setTheme(); QMainWindow, the native
|
||||
# QTabWidget/QStatusBar and the Windows title bar keep the OS palette unless
|
||||
# the palette, an app stylesheet and the DWM title bar attributes follow suit
|
||||
# (same approach as DLPilot app_fluent.py).
|
||||
_SURFACES = {
|
||||
False: {"window": "#f4f6f8", "base": "#ffffff", "text": "#1f2328",
|
||||
"dim": "#57606a", "border": "#d8dee4", "selected_text": "#ffffff"},
|
||||
True: {"window": "#202020", "base": "#2b2b2b", "text": "#f5f5f5",
|
||||
"dim": "#9a9a9a", "border": "#3a3a3a", "selected_text": "#1f2328"},
|
||||
}
|
||||
|
||||
|
||||
class ThemeManager(QObject):
|
||||
"""Keep the appearance choice persistent and synchronized with Qt."""
|
||||
|
||||
MODES = {"system", "light", "dark", "dark1", "dark2"}
|
||||
_THEMES = {
|
||||
"system": Theme.AUTO,
|
||||
"light": Theme.LIGHT,
|
||||
"dark": Theme.DARK,
|
||||
"dark1": Theme.DARK,
|
||||
"dark2": Theme.DARK,
|
||||
}
|
||||
_ACCENTS = {
|
||||
"light": "#0f6cbd",
|
||||
"dark": "#f2c94c",
|
||||
"dark1": "#5aa9e6",
|
||||
"dark2": "#35c6c8",
|
||||
}
|
||||
|
||||
def __init__(self, app):
|
||||
super().__init__(app)
|
||||
self.app = app
|
||||
self.window = None
|
||||
self.settings = QSettings("LT8619C-Tools", "SerialMate")
|
||||
mode = self.settings.value("appearance/theme", "system")
|
||||
self.mode = mode if mode in self.MODES else "system"
|
||||
self.apply()
|
||||
app.styleHints().colorSchemeChanged.connect(self.apply)
|
||||
|
||||
def set_window(self, window):
|
||||
"""Register the main window so the native title bar follows the theme."""
|
||||
self.window = window
|
||||
self._apply_titlebar()
|
||||
|
||||
def set_mode(self, mode):
|
||||
if mode not in self.MODES:
|
||||
raise ValueError(f"Unknown theme: {mode}")
|
||||
self.mode = mode
|
||||
self.settings.setValue("appearance/theme", mode)
|
||||
self.apply()
|
||||
|
||||
def is_dark(self):
|
||||
if self.mode in {"dark", "dark1", "dark2"}:
|
||||
return True
|
||||
return self.mode == "system" and self.app.styleHints().colorScheme() == Qt.ColorScheme.Dark
|
||||
|
||||
def apply(self, *_):
|
||||
is_dark = self.is_dark()
|
||||
setTheme(self._THEMES[self.mode])
|
||||
setThemeColor(self._ACCENTS.get(self.mode, self._ACCENTS["light"]))
|
||||
self._apply_palette(is_dark)
|
||||
self._apply_titlebar()
|
||||
|
||||
def _apply_palette(self, is_dark):
|
||||
"""Give native Qt surfaces the same colors as the Fluent widgets."""
|
||||
surface = _SURFACES[is_dark]
|
||||
accent = QColor(self._ACCENTS.get(self.mode, self._ACCENTS["light"]))
|
||||
palette = QPalette()
|
||||
for role, color in (
|
||||
(QPalette.Window, surface["window"]),
|
||||
(QPalette.Base, surface["base"]),
|
||||
(QPalette.AlternateBase, surface["base"]),
|
||||
(QPalette.Text, surface["text"]),
|
||||
(QPalette.WindowText, surface["text"]),
|
||||
(QPalette.Button, surface["base"]),
|
||||
(QPalette.ButtonText, surface["text"]),
|
||||
(QPalette.PlaceholderText, surface["dim"]),
|
||||
(QPalette.Highlight, accent),
|
||||
(QPalette.HighlightedText, surface["selected_text"]),
|
||||
(QPalette.ToolTipBase, surface["base"]),
|
||||
(QPalette.ToolTipText, surface["text"]),
|
||||
):
|
||||
palette.setColor(role, QColor(color))
|
||||
self.app.setPalette(palette)
|
||||
self.app.setStyleSheet(f"""
|
||||
QMainWindow, QWidget#root {{ background-color: {surface['window']}; color: {surface['text']}; }}
|
||||
QTabWidget::pane {{ background: {surface['base']}; border: 1px solid {surface['border']}; border-radius: 6px; }}
|
||||
QTabBar {{ qproperty-drawBase: 0; }}
|
||||
QTabBar::tab {{ background: transparent; color: {surface['dim']}; padding: 6px 16px;
|
||||
border: 1px solid transparent; border-top-left-radius: 6px;
|
||||
border-top-right-radius: 6px; }}
|
||||
QTabBar::tab:selected {{ background: {surface['base']}; color: {surface['text']};
|
||||
border: 1px solid {surface['border']}; }}
|
||||
QTabBar::tab:hover:!selected {{ background: {surface['base']}; }}
|
||||
QSplitter::handle {{ background: {surface['window']}; }}
|
||||
QStatusBar {{ background: {surface['window']}; color: {surface['dim']};
|
||||
border-top: 1px solid {surface['border']}; }}
|
||||
QToolTip {{ background-color: {surface['base']}; color: {surface['text']};
|
||||
border: 1px solid {surface['border']}; }}
|
||||
""")
|
||||
|
||||
def _apply_titlebar(self):
|
||||
"""Ask DWM for a title bar in the current surface color (Win10/11)."""
|
||||
if self.window is None or os.name != "nt" or not hasattr(ctypes, "windll"):
|
||||
return
|
||||
try:
|
||||
hwnd = int(self.window.winId())
|
||||
dwm = ctypes.windll.dwmapi
|
||||
dark = ctypes.c_int(1 if self.is_dark() else 0)
|
||||
dwm.DwmSetWindowAttribute(hwnd, 20, ctypes.byref(dark), ctypes.sizeof(dark))
|
||||
surface = _SURFACES[self.is_dark()]
|
||||
dwm.DwmSetWindowAttribute(hwnd, 35, ctypes.byref(self._colorref(QColor(surface["window"]))), 4)
|
||||
dwm.DwmSetWindowAttribute(hwnd, 36, ctypes.byref(self._colorref(QColor(surface["text"]))), 4)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
@staticmethod
|
||||
def _colorref(color):
|
||||
return ctypes.c_int(color.red() | (color.green() << 8) | (color.blue() << 16))
|
||||
@@ -1,143 +1,218 @@
|
||||
# agent.md — 仓库交接档案（供后续 Agent 接手）
|
||||
# agent.md — 项目开发需求与进度管理
|
||||
|
||||
> **成文方式**：2026-09-20 由一次会话从 git 全部 40 次提交（6243b8c…e354423）、
|
||||
> `DLPilot/AGENTS.md`、各级 README、`.zcode/plans/` 计划文件还原整理；不含任何口头
|
||||
> 讨论内容，一切以仓库工件为准。
|
||||
>
|
||||
> **分工**：本文管"宏观脉络、决策史、待办"；工程约定/不变量/构建规程在
|
||||
> `DLPilot/AGENTS.md`（**改代码前必读**）；使用说明在根与各工具 README。
|
||||
> 按 `C:\Users\Lenovo\.zcode\AGENTS.md`（用户级默认指令·默认工作约定）维护：
|
||||
> 记录项目约定与开发进度——已完成功能清单、已提出但尚未实现的计划——随开发持续更新。
|
||||
> 工程约束与构建规程在各工具 `AGENTS.md`；使用说明在根与各工具 README。
|
||||
> 内容以仓库工件为准，每次完成开发或有新需求提出后同步更新本文。
|
||||
|
||||
## 1. 项目定位
|
||||
## 1. 项目定位与约定
|
||||
|
||||
- 本仓库是 **LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板**的调试上位机工具集，
|
||||
服务上游固件仓 `hulk/LT8619C_DLPC3421_HDMI`（本机路径
|
||||
- 本仓库是**全部调试工具的收纳仓**（起家于 **LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板**
|
||||
调试配套）。原名 `LT8619C_Debug_Tools`，2026-09-28 更名 `HW-Debug-Tools`：Gitea 已改名
|
||||
（旧地址自动重定向）、本地目录与 remote 同步更名；Gitea Release 同日清理为各已发布工具
|
||||
仅保留最新版（DLPilot v0.4.0 / EDID-Viewer v0.1.0 / SerialMate v0.1.0），
|
||||
旧 release 删除但 tag 与提交历史保留。服务上游固件仓 `hulk/LT8619C_DLPC3421_HDMI`（本机路径
|
||||
`E:\Hulk-Coding\LT8619C_DLPC3421_HDMI`，同 Gitea 实例 gitea.hulk.wang）。
|
||||
光机 RS485 协议**唯一权威**是上游仓 `protocols.md`，本仓不维护协议副本。
|
||||
- 两个工具：
|
||||
- 工具链（全仓统一）：Python 3.14；GUI 用 PySide6 + PySide6-Fluent-Widgets，解析/协议
|
||||
模块纯标准库；PyInstaller onefile 打包；发布流水线 build_exe → package_release →
|
||||
publish_gitea（`GITEA_TOKEN` 用户级环境变量；实例 TLS 间歇抽风，实际请求加
|
||||
`--insecure`，详见 `DLPilot/AGENTS.md` §5）。
|
||||
- 结构约定：每个工具三区目录（**src/ 人写 / assets/ 可再生 / release/ 交付**）+ 双文档
|
||||
（README 使用说明 / AGENTS.md 工程约束与进度）。各工具独立开发、独立打标签发布，
|
||||
Release 列表按时间倒序混排于同一页面：
|
||||
- **DLPilot**（原 HDMI-Tool）＝"3D 光固化光机调试台"：HDMI 源端（EDID/分辨率/
|
||||
测试图案投屏）+ 光机控制（RS485→板上 GD32E230 网关→DLPC3421）+ 电源检查
|
||||
（PD 自检/FPDO 挡位判定/功率检测）。
|
||||
- **I2C-Inject**：RP2040 固件 + PC GUI，在 demo 板 I2C 总线上择机注入读写 LT8619C
|
||||
寄存器（避让主控 500ms 轮询，写后读回校验）。
|
||||
测试图案投屏）+ 光机控制（RS485→GD32E230 网关→DLPC3421）+ 电源检查。
|
||||
- **EDID-viewer**：Windows 显示器 EDID 只读查看器（Fluent UI）。
|
||||
- **SerialMate**：RS485/串口调试助手，帧格式（包头/板ID/LEN/CRC）可定制，
|
||||
默认兼容 DLPilot 光机协议；payload 字符串/HEX 显示、4 通道曲线、payload
|
||||
自动包装发送。
|
||||
- **I2C-Inject**：RP2040 固件 + PC GUI，demo 板 I2C 总线择机注入读写寄存器。
|
||||
**2026-09-25 起暂停开发**，代码与固件保留备查。
|
||||
- 子模块引用：`gd32e230f8_firmware_merge_tool/`（2026-09-30 接入，git submodule 指向
|
||||
`hulk/gd32e230f8_firmware_merge_tool`）——GD32E230 APP/BL 合成补齐
|
||||
（`_UPDATE.bin`/`_BL.bin`）+ DAPLink Flash GUI 烧录。代码、版本与发布均在原仓库
|
||||
独立管理，本仓只锁指针；新克隆 `git submodule update --init` 拉取，跟进上游
|
||||
`git submodule update --remote gd32e230f8_firmware_merge_tool` 后随本仓提交新指针。
|
||||
- 镜像约定：`EDID-viewer` 主目录（`E:\Hulk-Coding\HW-Debug-Tools\EDID-viewer`）
|
||||
改动后需 robocopy /MIR 同步到 `E:\Hulk-Coding\LT8619C\_Debug\_Tools\EDID-viewer`
|
||||
（排除 .venv/build/__pycache__/.git，zip 不同步）。
|
||||
- 发布约定：源码与打包产物（exe、运行配置）入库；发布 zip 不入库，只上传 Gitea Release。
|
||||
|
||||
## 2. 当前状态快照（2026-09-24，v0.4.0）
|
||||
## 2. 开发进度（已完成功能清单）
|
||||
|
||||
- 当前入口为 `DLPilot/src/app_fluent.py`，`APP_VERSION = "0.4.0"`；使用
|
||||
PySide6-Fluent-Widgets。旧 `app_gui.py` 保留作历史对照，不再由入口加载。
|
||||
- 本次发布为 `DLPilot-v0.4.0`，源码、文档与 `release/DLPilot.exe` 合并为一个提交；
|
||||
zip 只上传 Gitea Release，不入库。远端完成状态以标签和附件查询为准。
|
||||
- 支持的模式、EDID 信息默认折叠；修复标题栏图标与 PD 成功状态绿色显示。
|
||||
- Light 显式同步 Qt 调色板、容器背景与 Windows 标题栏，浅灰主背景、白色卡片、深色文字；
|
||||
保留 Dark/System 切换。主题不写入用户的 `pattern_slots.json`。
|
||||
- Qt 单文件打包收集 `qfluentwidgets` 资源与系统 `icuuc.dll`，启动注册并预加载
|
||||
Qt/Shiboken DLL，避免 QtCore 导入失败。
|
||||
- 已完成源码编译、无硬件 RS485 自测（ALL PASS）、Qt 离屏浅色渲染检查和正式 EXE
|
||||
定时启动退出（exit=0）。本次原生桌面自动化接口不可用，未完成成品 Light 截图；
|
||||
不应将离屏截图等同于成品完整视觉或硬件验收。
|
||||
- 本机 `release/pattern_slots.json` 的 COM5 运行配置与 `EDID-viewer/` 未跟踪目录
|
||||
不属于本次发布；保留本地文件，提交及发布使用仓库预置配置。
|
||||
### 2.1 DLPilot — 最新发布 v0.4.0（2026-09-24）
|
||||
- HDMI 源端：EDID 查看/逐字节解析、分辨率切换、智能显示拓扑（仅拉回转接板屏）、
|
||||
纯色/黑白/测试卡全屏投屏、自定义槽位（pattern_slots.json）。
|
||||
- 光机控制：RS485 链路（`dlpc_rs485.py` 帧协议+线程）、开关光机/设光强/TEC 控温/
|
||||
查温度电流，串口参数化。
|
||||
- 电源检查：PD 自检（M301→M302→M303 状态机）、FPDO 挡位判定、功率检测
|
||||
（M303+M304+M305 → V/mA/W 两位小数）。
|
||||
- 界面：PySide6-Fluent-Widgets 双栏仪表盘（v0.4.0 起），Light/Dark/System 主题
|
||||
（Fluent 主题 + Qt 调色板 + QSS + DWM 标题栏三件套同步）。
|
||||
- 发布：v0.1.0（HDMI-Tool）→ v0.2.0 → v0.3.x → v0.4.0 均已上传 Gitea Release
|
||||
（v0.3.6 未单独发布，功能被 v0.4.0 覆盖）；远端标签与附件已核对。
|
||||
|
||||
## 3. 开发方向主线（时间线）
|
||||
### 2.2 EDID-Viewer — 最新发布 v0.1.0（2026-09-25）
|
||||
- 解析：EDID 1.x 基础身份/时序、CTA（音频 SAD/HDMI VSDB/CEC/HF-VSDB）、HDR 与
|
||||
色彩能力、逐块校验与越界诊断（`edid.py` 纯标准库 + 9 项单测，含随机畸形数据
|
||||
无崩溃检查）。
|
||||
- 数据获取：Windows WMI 只读枚举活动设备（HDMI/DP/内屏连接类型）；离线
|
||||
`.bin/.edid/.hex/.txt` 导入；BIN 与 JSON 报告导出。
|
||||
- 界面：Fluent 卡片布局、分组页签（设备与能力/时序/原始 HEX/完整 JSON）、右上角
|
||||
"关于"（v0.1.0）。
|
||||
- 主题：Light/Dark/dark1/dark2/跟随系统，三件套同步 + QSettings 持久化 +
|
||||
系统明暗变化响应。
|
||||
- 工程化：目录与发布流水线对齐 DLPilot（onefile exe 入库）；标签
|
||||
`EDID-Viewer-v0.1.0` 与 Release 附件（66,483,477 字节）已核对。
|
||||
|
||||
**阶段 0 · 寄存器语义实测期（09-03）**
|
||||
I2C-Inject + HDMI-Tool 首版落库。核心成果：0x606E 位交换 / 0x606D 整组顺序两个
|
||||
寄存器语义经 demo 板逻辑分析仪双色交叉实测确立（LA 波形判读脚本
|
||||
`la_wave_analyzer*.py` 即为该过程产物，配套 I2C-Inject 固件内置总线嗅探）。
|
||||
### 2.3 SerialMate — v0.1.0（2026-09-27，首版）
|
||||
- **更名**：原名 SerialAssistant（目录/exe/文档/配置同步更名；旧配置
|
||||
serial_assistant.json 首次启动自动迁移为 serial_mate.json；图标与名字
|
||||
无绑定为波形+RS485 母题）。用户确认 "SerialMate 吧"（2026-09-27）。
|
||||
- **已发布**：commit d133906 推送 main 并打 tag `SerialMate-v0.1.0`，
|
||||
Release 附件 `SerialMate-v0.1.0-win64.zip`（63.7 MB）已上传核对。
|
||||
- 协议：**帧构成令牌序列可定制**（`HDR ID LEN PAYLOAD CRC` + 十六进制字面量
|
||||
同步头，收发共用布局仅包头分方向；支持字段换序/无板ID/多字节同步头，LEN
|
||||
口径 payload 长度/到帧尾/整帧三种）、5 种 CRC 算法 × 3 种覆盖范围，默认与
|
||||
DLPilot 光机 RS485 协议一致（D5/B5/01/SUM8/不含包头）；增量解析前缀逐位
|
||||
对齐 + CRC 失败逐字节重同步；自测 64 项全 PASS（DLPilot 实测帧向量 +
|
||||
CRC 标准校验值 + 布局换序/LEN 口径向量 + 布局模糊往返）。
|
||||
- 链路：串口参数热切换、半双工友好发送队列（未连接丢弃）、解析/透传双模式
|
||||
热切、`loop://` 虚拟回环自检 13 项全 PASS（组帧→发送→接收→解析→曲线提取）。
|
||||
- GUI（PySide6-Fluent-Widgets，用户指定沿用 Qt 方案）：帧构成/LEN 口径可视化
|
||||
编辑，payload 字符串/HEX 切换（半透明底色高亮）、原始帧 hex、时间戳、日志
|
||||
保存；4 通道曲线（三种提取 + 倍率，**弹窗独立**：时间窗滑笔回看、纵轴刻度、
|
||||
悬停读值、暂停渲染/自动Y/滚轮缩放/拖动 Y 轴）；发送自动包装（输入 payload
|
||||
自动组帧，`/` 分隔多条依次发）、HEX 直发、周期发送、组帧实时预览、历史
|
||||
回溯、回车发送；主题跟随系统；标题栏版本号 + 关于弹窗 + 图标（波形 RS485）。
|
||||
- 板型档案（2026-09-27 实机反馈追加）：不同板子的"协议参数+命令预设表"存为
|
||||
命名档案（board_profiles.json，不入库，首次运行生成默认 DLPilot 板型），
|
||||
发送卡一键切换/新建/存为/删除/表格编辑/重载。
|
||||
- 发布：SerialMate.exe 已入库（随帧构成功能重建），zip/Release 未发布
|
||||
（待用户验收后走 package_release + publish_gitea）。
|
||||
|
||||
**阶段 1 · 工程化与发布流水线（09-10）**
|
||||
确立三区目录（src 人写 / assets 可再生 / release 交付）+ 双文档（README 给人 /
|
||||
AGENTS.md 给 Agent）；打通 build_exe → package_release → publish_gitea 流水线，
|
||||
发布 HDMI-Tool v0.1.0。同期收录启动强制扩展显示拓扑与波形/注入脚本。
|
||||
### 2.4 I2C-Inject — ⏸ 暂停开发（2026-09-25）
|
||||
- 已完成：RP2040 注入器固件（MicroPython，内置 viper 总线嗅探）、PC 端 GUI、
|
||||
demo 板寄存器语义实测（0x606E bit5=镜像 D[7:0]、0x606D 整组顺序，逻辑分析仪
|
||||
双色交叉验证）。
|
||||
- 状态：暂停开发，代码与固件保留备查，README 顶部有状态横幅。
|
||||
|
||||
**阶段 2 · 光机 RS485 控制集成（09-11，v0.2.0）**
|
||||
新增 `dlpc_rs485.py`：帧构造 `D5 01 LEN <ASCII> CRC` / 响应 `B5 TYPE LEN <payload> CRC`
|
||||
（累加和校验）、增量解析、译码表、DLPC485 链路类（daemon 线程+队列+回调，
|
||||
模式照搬 I2C-Inject 的 Injector）。启动拓扑从"无条件扩展"改为**智能判定**。
|
||||
串口下拉显示设备描述（CH344 多口可辨）。计划文件 `.zcode/plans/plan-sess_a1d8*.md`
|
||||
即此阶段方案，已完整执行。
|
||||
## 3. 开发需求与计划（已提出、尚未实现）
|
||||
|
||||
**阶段 3 · GUI 重构与产品化（09-12，v0.3.0）**
|
||||
feature/ctk-ui 分支完成 CustomTkinter 双栏仪表盘重构（规格：`UI参考布局.svg`）；
|
||||
产品更名 **HDMI-Tool → DLPilot**（3D 光固化光机调试台）；光机串口参数化（默认
|
||||
8-N-1）+ TEC 控制（M7/M8）与温度实时显示；DLP/Pilot 双行图标。
|
||||
### 3.1 DLPilot
|
||||
- 【待素材】校准图案槽位预置为空：第二排 5 个槽位为 3D 光固化测试/校准图预留
|
||||
（`file: null`）；素材到位后 assets/ → 生成脚本入库 → 更新 slots → 重新打包。
|
||||
- 【待真机帧·低优先】M305 回归向量是按协议推演的（selftest_rs485.py:90 起，
|
||||
0x8CA0=36000mW 为推演值）：真机功率显示已实测对接，仅剩把自测向量换成真机抓包，
|
||||
让无硬件回归更贴近真机。
|
||||
- 【新需求·已确认可行（2026-09-25）】画面镜像（横/纵独立翻转，任意来源画面）：
|
||||
投影观看方向（正投/背投/吊装）需要源信号预先翻转。DLPC3421 原生支持——I2C 14h
|
||||
"写入显示图像方向"（b1=长轴翻转、b2=短轴翻转，两轴独立；15h 读回；b0 旋转仅竖排源
|
||||
且 DLPC3421 不支持）。实施分两段：
|
||||
- 上游固件（协议权威在上游仓）：`dlpc3421.h` 已定义 14h/15h 命令号但驱动未实现——
|
||||
照 `dlpc3421_set/get_mirror_lock_control` 模式补 set/get 函数，再暴露为 M 命令
|
||||
（现有 M981~M983 是只读调试命令，可续编 M984=设置/M985=读取，命名以上游为准），
|
||||
登记进 protocols.md；上电/软重启后是否自动恢复保存的方向由固件决定。
|
||||
**命名陷阱**：现有 `set/get_mirror_lock_control`（39h"镜片锁定控制"）是出厂 DMD
|
||||
接口锁定校准用，不是图像镜像，勿混用。
|
||||
- 上位机 DLPilot：`dlpc_rs485.py` 加命令封装，光机卡加"水平镜像/垂直镜像"开关并
|
||||
读回回显；用方向不对称图案（如 bw_sweep/文字图）实测确认长轴/短轴与横/纵的对应。
|
||||
- 备选（若固件暂不动）：DLPilot 自投图案/自定义图片可在 Qt 渲染时翻转（仅覆盖测试
|
||||
内容）；任意桌面内容 Windows 标准 API 只有 180°（=两轴同时），单方向翻转做不到。
|
||||
|
||||
**阶段 4 · 体验打磨（09-14，v0.3.1/0.3.2/0.3.3）**
|
||||
投屏退出语义两轮更名（"恢复桌面"→"停止投屏"→"停止测试图像"）；标题栏版本号；
|
||||
清理残余 HDMI-Tool 引用与目录更名；修复 USB 拔出后同参数重连失效（掉线分支
|
||||
清 `_open_key`）。
|
||||
### 3.2 EDID-Viewer
|
||||
- EDID 对比、字节差异与固件数组导出。
|
||||
- HDMI Forum VRR/ALLM/FRL/DSC、DisplayID 与高级色彩数据解析（第一版有意不解，
|
||||
保留原始块供分析）。
|
||||
- 与实际输出时序和桥接芯片寄存器联合诊断。
|
||||
- 实机验收缺口：HDMI 热插拔、多屏、跨屏 DPI、最大化/恢复与导入导出完整交互
|
||||
（见 `EDID-viewer/VALIDATION.md`）。
|
||||
|
||||
**阶段 5 · 电源检查卡（09-17~18，v0.3.4~0.3.6）**
|
||||
- **电源自检**：M301(协议)→M302(挡位电流)→M303(实测电压) 三步帧驱动状态机，
|
||||
FPDO 判定＝电压就近 PD 固定挡（5/9/12/15/20/28V ±5%）+ 挡位电流；12V 且 ≥3A
|
||||
绿底，挡位不符红底，无匹配 ERR（CH224Q 电压配置寄存器只写不可读，只能实测判定）。
|
||||
- **功率检测**：M303+M304+M305 三步序列 → 电压 V / 电流 mA / 功率 W（两位小数）。
|
||||
- **M30x 载荷是二进制例外**（SQ52205 实测）：大端原始值非 ASCII，必须走
|
||||
`payload_bytes()`；M303=u16 mV、M304=s16 补码 mA、M305=u32 mW（LEN=4）。
|
||||
封装在 `payload_u16_be/payload_s16_be/payload_u32_be/format_power`。
|
||||
- 伴随一串稳定性修复（详见 §4）。
|
||||
### 3.3 SerialMate
|
||||
- 【待真机】光机实机收发与温度曲线实测（M201 ×0.1 提取），当前仅回环验证。
|
||||
- 【无图标】assets/serial-mate.ico 未生成（build_exe.py 已预留路径）。
|
||||
- 发送批处理脚本化（延时/循环/等待应答）；曲线数据导出 CSV。
|
||||
|
||||
**阶段 6 · Fluent UI 重写（09-24，v0.4.0）**
|
||||
PySide6-Fluent-Widgets 替换 CustomTkinter 主界面，延续 EDID、测试图案、RS485、
|
||||
PD/功率/温度/电流及自定义槽位功能；GUI 图案窗口使用 Qt，CLI 图案仍走 tkinter。
|
||||
补齐模式/EDID 折叠、PD 成功状态颜色、图标、Light 调色板与 Qt 单文件 DLL 加载。
|
||||
### 3.4 I2C-Inject
|
||||
- 暂停开发期间不列计划；恢复时以其 README 现状为准。
|
||||
|
||||
## 4. 尝试过 / 推翻过 / 反复调过的思路（勿重蹈）
|
||||
### 3.5 明确不做（决策，非待办）
|
||||
- **0x606E 的 0x40/0x80 位交换不再单独实测**（2026-09-25 用户确认：当前行为正常、
|
||||
符合预期，bit5 实测基线已够用；原【待硬件】项关闭）。
|
||||
- TI 原始 I2C 命令透传不做：GD32 网关固件只收 ASCII M 命令集（v0.2.0 显式决策）。
|
||||
- DLPilot 不引入 pyserial/Pillow 硬依赖：保持 try-import + HAS_* 标志 + 缺失降级。
|
||||
- EDID-Viewer 不承诺实时 DDC 抓取：数据来自 Windows/显卡驱动，可能缓存或覆盖。
|
||||
|
||||
## 4. 决策史：时间线与踩坑（勿重蹈）
|
||||
|
||||
**阶段 0 · 寄存器语义实测期（09-03）**：I2C-Inject + HDMI-Tool 首版落库；0x606E
|
||||
位交换 / 0x606D 整组顺序经 demo 板 LA 双色交叉实测确立（`la_wave_analyzer*.py`
|
||||
即该过程产物）。
|
||||
|
||||
**阶段 1 · 工程化与发布流水线（09-10）**：确立三区目录 + 双文档；打通
|
||||
build_exe → package_release → publish_gitea，发布 HDMI-Tool v0.1.0。
|
||||
|
||||
**阶段 2 · 光机 RS485 控制集成（09-11，v0.2.0）**：新增 `dlpc_rs485.py`（帧构造/
|
||||
增量解析/译码表/DLPC485 链路类，模式照搬 I2C-Inject 的 Injector）；启动拓扑改智能判定。
|
||||
|
||||
**阶段 3 · GUI 重构与产品化（09-12，v0.3.0）**：CustomTkinter 双栏仪表盘
|
||||
（规格 `UI参考布局.svg`）；更名 HDMI-Tool → DLPilot；TEC 控制与温度实时显示。
|
||||
|
||||
**阶段 4 · 体验打磨（09-14，v0.3.1~0.3.3）**：投屏退出语义两轮更名；标题栏版本号；
|
||||
修复 USB 拔出后同参数重连失效。
|
||||
|
||||
**阶段 5 · 电源检查卡（09-17~18，v0.3.4~0.3.6）**：电源自检状态机、功率检测、
|
||||
M30x 二进制载荷封装（详见踩坑 1~3、10）。
|
||||
|
||||
**阶段 6 · DLPilot Fluent UI 重写（09-24，v0.4.0）**：PySide6-Fluent-Widgets 替换
|
||||
CustomTkinter；补齐折叠、PD 状态颜色、Light 调色板与 Qt 单文件 DLL 加载。
|
||||
|
||||
**阶段 7 · EDID-Viewer 独立成工具（09-23~25，v0.1.0）**：从 DLPilot 的源端 EDID
|
||||
需求独立；目录与流水线对齐；同期 I2C-Inject 标记暂停开发，根 README/agent.md
|
||||
按三工具更新。
|
||||
|
||||
| # | 问题 | 最初做法 → 最终做法 / 教训 |
|
||||
|---|---|---|
|
||||
| 1 | 电源自检成功判定 | 先按 ASCII `ok` 前缀判成功 → 实机 M301 回包 payload=`PD` 无前缀被误判错误（9772a2b）→ **改按帧 TYPE=0xF0 译码分类**。教训：M30x 系列回包不能按文本判 |
|
||||
| 2 | 功率值来源 | 先用 M303×M304 计算 P=UI 占位显示（2b7d103，"待固件功率命令"）→ 固件提供 M305 直读 u32 mW 后改为三步序列直读（9b29b6a） |
|
||||
| 3 | 二进制载荷三连坑 | ① Frame.payload 解出乱码 → 用 `payload_bytes()` 取原始字节；② M305 是 LEN=4，复用双字节解析会错 → 按 kind 校验长度；③ 日志行含 NUL 导致复制被截断 → 二进制载荷日志行以 hex 展示（e354423） |
|
||||
| 2 | 功率值来源 | 先用 M303×M304 计算 P=UI 占位显示（2b7d103）→ 固件提供 M305 直读 u32 mW 后改为三步序列直读（9b29b6a） |
|
||||
| 3 | 二进制载荷三连坑 | ① `Frame.payload` 解出乱码 → 用 `payload_bytes()` 取原始字节；② M305 是 LEN=4，复用双字节解析会错 → 按 kind 校验长度；③ 日志行含 NUL 复制被截断 → 二进制载荷日志行以 hex 展示（e354423） |
|
||||
| 4 | "串口断不开" | 表象是断开逻辑 bug，实际根源是**双实例互抢串口** → 单实例锁 + 串口占用提示（e87bf14） |
|
||||
| 5 | 窗口最大化卡顿 | EDID 信息区 CTkScrollableFrame+40 余个逐行 Label，最大化时逐控件重绘 → 换 CTkTextbox 整体重排，开销低一个量级（30bc224） |
|
||||
| 6 | 启动强制扩展拓扑 | 无条件 `SetDisplayConfig` 扩展会打扰用户自选拓扑（如家里"仅第二屏幕"）→ 仅当未激活显示器 EDID 厂商字节为转接板签名 `61 93`("XLS") 时才拉回（d9ecff4） |
|
||||
| 7 | GUI 框架 | 原生 tkinter → CustomTkinter 双栏仪表盘（84838e3）；v0.4.0 再迁移到 PySide6-Fluent-Widgets；旧 CTk 文件仅供历史对照 |
|
||||
| 8 | 投屏退出按钮文案 | "恢复桌面"→"停止投屏"→"停止测试图像"（3f35ad2→b167ce3）：最终语义是关测试图窗口，与显示拓扑恢复无关 |
|
||||
| 9 | USB 拔出后重连失效 | 掉线分支未清 `_open_key`，同参数重连被"参数未变"逻辑跳过 → 掉线同步清缓存（51e2f1c） |
|
||||
| 10 | 电源自检卡死 | 帧路由引用未定义变量 `payload`（3f36ead），改名/重构时注意帧回调的作用域 |
|
||||
| 11 | Gitea 发布 | python urllib 访问该实例间歇 `SSL: UNEXPECTED_EOF` → 必须 `--insecure`；`GET /releases/tags/{tag}` 的 assets 是纯数组而 `GET /releases/{id}` 是 `{items:[...]}`，publish_gitea.py 已兼容两种形状，勿"简化"；请求自动重试已加（f0f8073） |
|
||||
| 5 | 窗口最大化卡顿 | CTkScrollableFrame+40 余个逐行 Label 最大化逐控件重绘 → 换 CTkTextbox 整体重排，开销低一个量级（30bc224） |
|
||||
| 6 | 启动强制扩展拓扑 | 无条件 `SetDisplayConfig` 会打扰用户自选拓扑 → 仅当未激活显示器 EDID 厂商字节为转接板签名 `61 93`("XLS") 时才拉回（d9ecff4） |
|
||||
| 7 | GUI 框架 | tkinter → CustomTkinter（84838e3）→ v0.4.0 PySide6-Fluent-Widgets；旧文件仅供历史对照 |
|
||||
| 8 | 投屏退出按钮文案 | "恢复桌面"→"停止投屏"→"停止测试图像"（3f35ad2→b167ce3）：最终语义是关测试图窗口，与拓扑恢复无关 |
|
||||
| 9 | USB 拔出后重连失效 | 掉线分支未清 `_open_key`，重连被"参数未变"跳过 → 掉线同步清缓存（51e2f1c） |
|
||||
| 10 | 电源自检卡死 | 帧路由引用未定义变量 `payload`（3f36ead），改名/重构时注意帧回调作用域 |
|
||||
| 11 | Gitea 发布 | urllib 间歇 `SSL: UNEXPECTED_EOF` → 必须 `--insecure`；`/releases/tags/{tag}` 的 assets 是纯数组而 `/releases/{id}` 是 `{items:[...]}`，publish_gitea.py 已兼容两种形状，勿"简化"；自动重试已加（f0f8073） |
|
||||
| 12 | Fluent Light 主题发黑 | 只调 `setTheme` 仅刷新 Fluent 控件，QMainWindow/原生 QTabWidget/QStatusBar/标题栏仍跟系统深色 → **三件套**：setTheme + QPalette/应用级 QSS + DWM 属性 20/35/36（EDID-Viewer `theme.py`，DLPilot 同源） |
|
||||
| 13 | PyInstaller 传 .spec 报错 | 给 .spec 再传 `--specpath` 报 "makespec options not valid" → spec 由 build_exe.py 生成后只传 distpath/workpath |
|
||||
| 14 | onefile 冒烟"没窗口" | onefile 引导父进程 MainWindowTitle 恒为空，轮询父进程误判失败 → 按进程名找子进程窗口（EDID-Viewer 实测 ~2s 起窗） |
|
||||
|
||||
## 5. 未实操 / 待办清单（接手者从这里挑活）
|
||||
|
||||
### 5.1 v0.4.0 发布交接
|
||||
v0.4.0 已覆盖未单独发布的 v0.3.6 功能与本次 Fluent UI 改动，无需另发 v0.3.6。
|
||||
发布时先推送代码与同提交标签，再上传 `DLPilot-v0.4.0-win64.zip`；
|
||||
核对远端标签提交、附件名称/大小，并记录验证结果。若需补传，先查询资产，避免重复上传。
|
||||
|
||||
### 5.2 【待硬件】0x606E 的 0x40/0x80 两组位交换
|
||||
demo 板仅实测了 bit5(0x20)=镜像 D[7:0]；0x40/0x80 对另外两组**未单独实测**，
|
||||
等自板（转接板）点亮时用 I2C-Inject 验证（见 I2C-Inject/README §3）。
|
||||
|
||||
### 5.3 【待素材】校准图案槽位预置为空
|
||||
测试图案卡第二排 5 个槽位 UI 标注"校准图案(齿轮改图)"，为 3D 光固化测试/校准图
|
||||
预留；`release/pattern_slots.json` 中这些槽位 `file: null`。拿到校准图素材后：
|
||||
放 assets/ → 生成脚本入库 → 更新预置 slots → 重新打包。
|
||||
|
||||
### 5.4 【待真机帧】M305 回归向量是算法推演帧
|
||||
`selftest_rs485.py` 中 M303/M304 用真机帧，M305 向量是按协议推演的；拿到真机
|
||||
M305 回包后替换向量，使回归更实。
|
||||
|
||||
### 5.5 README 已同步
|
||||
本次已将根 README 与 DLPilot/README 的安装依赖、界面描述和日期更新到 v0.4.0。
|
||||
|
||||
### 5.6 【明确"不做"，非待办】
|
||||
- **TI 原始 I2C 命令透传不做**：GD32 网关固件只收 ASCII M 命令集（v0.2.0 计划的
|
||||
显式决策）。
|
||||
- **不引入 pyserial 硬依赖**：保持 try-import + HAS_* 标志 + 缺失降级的可选依赖
|
||||
模式（Pillow 同理）。
|
||||
|
||||
## 6. 快速上手（完整规程见 DLPilot/AGENTS.md §5/§7）
|
||||
## 5. 快速上手（完整规程见各工具 AGENTS.md）
|
||||
|
||||
```powershell
|
||||
# DLPilot（完整清单：DLPilot/AGENTS.md §5/§7）
|
||||
cd DLPilot/src
|
||||
python -m compileall -q . # 编译检查
|
||||
python selftest_rs485.py # 光机协议回归（改 dlpc_rs485.py 后必跑）
|
||||
python hdmi_gui.py --seconds 5 # GUI 冒烟
|
||||
python build_exe.py # 打包 → ../release/DLPilot.exe
|
||||
python package_release.py 0.4.0 # 组装当前版本 zip；新版本先更新 APP_VERSION
|
||||
python -m compileall -q . ; python selftest_rs485.py # 编译检查 + 光机协议回归
|
||||
python hdmi_gui.py --seconds 5 # GUI 冒烟
|
||||
python build_exe.py ; python package_release.py 0.4.0 # 打包 + 组装 zip
|
||||
python publish_gitea.py ../release/DLPilot-v0.4.0-win64.zip --replace --insecure
|
||||
|
||||
# EDID-Viewer（完整清单：EDID-viewer/AGENTS.md）
|
||||
cd EDID-viewer/src
|
||||
python -m unittest # 9 项解析测试（改 edid.py 后必跑）
|
||||
python build_exe.py ; python package_release.py 0.1.0 # 打包 + 组装 zip
|
||||
python publish_gitea.py ../release/EDID-Viewer-v0.1.0-win64.zip --insecure
|
||||
|
||||
# SerialMate（完整清单：SerialMate/AGENTS.md）
|
||||
cd SerialMate/src
|
||||
python selftest.py ; python selftest_loop.py # 协议回归 + 链路回环(改协议/链路后必跑)
|
||||
python main.py --seconds 5 # GUI 冒烟
|
||||
python build_exe.py ; python package_release.py 0.1.0 # 打包 + 组装 zip
|
||||
python publish_gitea.py ../release/SerialMate-v0.1.0-win64.zip --insecure
|
||||
```
|
||||
|
||||
上游协议/寄存器语义问题先查上游仓 `protocols.md` 与 `doc/architecture/`；
|
||||
本仓改动约束（目录契约、12 条代码不变量、领域测试值含义）以 `DLPilot/AGENTS.md`
|
||||
为准，**其中领域语义的测试值（55/AA/FF、640x360、800x600@60）有明确用途，勿顺手改**。
|
||||
本仓改动约束以两个工具的 AGENTS.md 为准——**其中领域语义的测试值
|
||||
（55/AA/FF、640x360、800x600@60）有明确用途，勿顺手改**。
|
||||
|
||||
Submodule
+1
Submodule gd32e230f8_firmware_merge_tool added at d776979a5a
Reference in New Issue
Block a user