环境文档小修:CMSIS pack 更正为非必装(keil.com 已下架)、串口配置源端口更正为 COM6

This commit is contained in:
2026-10-02 22:56:07 +08:00
parent 401908c062
commit c441131db6
2 changed files with 6 additions and 5 deletions
+1 -1
View File
@@ -107,7 +107,7 @@ STM32F407ZGTx @168MHz(HSE 8MHz → PLL M=4/N=168/P=2);**仅 Keil MDK-ARM v
- 入口:`& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py <命令>`(daemon 自动拉起;全部命令 5s 超时、JSON 输出、exit 0/1/2/3)
- 全量历史 = 日志文件 `tools/serial_tool/state/serial.log`(RX/TX/SYS 时间戳行);agent 直接 Read/Grep 文件,**无采集窗口仪式**;20MB 上限自动截头保尾 10MB
- 常用:`open`(幂等)/ `send <文本>`(或 `--hex 0D0A`)/ `log --tail N --grep P` / `clear`(代际+1)/ `wait-idle --settle-ms 8000 --max-ms 30000` / `status` / `close`
- 串口端口单一配置源:`.opencode/serial_config.json`(当前 COM7);端口变化**只改这个文件**
- 串口端口单一配置源:`.opencode/serial_config.json`(当前 COM6,2026-09-21 台架重插后由 COM7 变更);端口变化**只改这个文件**
- 命令/工作流/故障排查 `docs/测试说明/串口助手使用指南.md`;契约/daemon 行为/陷阱 `docs/测试说明/串口助手设计说明.md`
- **抓开机日志铁律(2026-09-20 实测)**:① 顺序 `open` → `clear` → 烧录/复位 → `wait-idle` → 读日志校验标记(**采集必须先于烧录**,否则错过开机头几行);② `wait-idle` 必须带 `--timeout <秒>`(CLI→daemon 默认 5s 硬超时会掐断长等待:`wait-idle --timeout 90 --settle-ms 8000 --max-ms 45000`);③ 标记校验直接 Read/Grep/Select-String `state/serial.log` 文件最可靠(`log --grep` 子命令实测不可信,勿作判定依据)
- **`open` 报"拒绝访问/端口被占用"时**:先查**残留旧 daemon**(上一会话遗留的 `serial_tool.py --serve` python 进程——口句柄已死但进程仍占着串口与 HTTP 口 18765)→ `taskkill /F /PID <旧PID>` → 重新 `open`(自动拉起新 daemon,系统自动释放口);改 `serial_config.json` 后同样必须先杀旧 daemon 再 `open`(daemon 启动时缓存配置)