feat: I2C-Lab v0.1.0 代码入库——RP2040 PIO 被动监控 probe 固件(pico-sdk C, 250MHz 双核) + Fluent 上位机(事务流/波形快照/CSV/演示模式)；release/ 交付物(exe/UF2/BIN/zip)不入库、本地保留待真机验收发布；根 README 工具表与 agent.md 登记；I2C-Inject README 标注后续并入 I2C-Lab；移除误登记的 OBI-1/ui-style-demo 相关内容

2026-10-13 15:41:29 +08:00
parent 74469cfe66
commit 42ff258b35
25 changed files with 3292 additions and 20 deletions
@@ -11,7 +11,8 @@
 | <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="I2C-Lab/assets/i2c-lab.png" width="64" alt="I2C-Lab 图标"/> | [I2C-Lab](I2C-Lab/) | I2C 总线监控调试台：RP2040 probe 固件纯被动监听（PIO 硬件捕获 + 实时解码，不加上拉不驱动），PC 端实时事务流（地址/RW/ACK/数据/收尾）、地址过滤、CSV 导出、逻辑分析仪式波形快照（滚轮缩放/事务注记）；主机读写与从机模拟在路线图上（前身 I2C-Inject 的注入职能将并入） | 到 [Releases](https://gitea.hulk.wang/hulk/HW-Debug-Tools/releases) 下 `I2C-Lab-vX.Y.Z-win64.zip`（含 probe 固件 UF2），解压即用；详见 [I2C-Lab/README.md](I2C-Lab/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-Lab（监控已就绪，注入将在其主机阶段复活） | 暂不提供发布；状态与原理详见 [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) |

 ## 环境要求
@@ -21,9 +22,11 @@
  `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`
+  I2C-Lab GUI 同上；重新构建 probe 固件需 pico-sdk 2.x + Arm GNU 交叉工具链
+  （见 I2C-Lab/AGENTS.md）
 - 重新打包：`DLPilot/src/build_exe.py`、`EDID-viewer/src/build_exe.py` 与
-  `SerialMate/src/build_exe.py`（均自动安装 PyInstaller）；I2C-Inject 目录内 `python build_exe.py`
+  `SerialMate/src/build_exe.py`、`I2C-Lab/src/build_exe.py`（均自动安装 PyInstaller）；
+  I2C-Inject 目录内 `python build_exe.py`

 ## 目录结构

@@ -50,22 +53,31 @@ HW-Debug-Tools/
 │   ├── release/             # SerialMate.exe + README（入库）；发布 zip（不入库）
 │   ├── README.md            # 使用说明
 │   └── AGENTS.md            # 工程档案
-├── I2C-Inject/              # PC 端 GUI + RP2040 固件 + 打包 exe + 图标 + README
+├── I2C-Lab/
+│   ├── src/                 # 解码/固件链路/波形控件/GUI + 自检 + 打包/发布脚本
+│   ├── firmware/            # probe 固件（pico-sdk C + PIO + make_uf2.py）
+│   ├── assets/              # 图标（I2C 橙色母题）
+│   ├── release/             # I2C-Lab.exe + firmware/i2c_lab.uf2（交付物本地保留，不入库；发布时走流水线）
+│   ├── README.md            # 使用说明
+│   └── AGENTS.md            # 工程档案
+├── I2C-Inject/              # ⏸ 暂停开发留档（PC GUI + MicroPython 固件 + 打包 exe + 图标 + README）
 ├── gd32e230f8_firmware_merge_tool/  # 🔗 git 子模块 → GD32E230 固件工具（独立仓库，见下方备注）
+├── icons/                   # 图标家族唯一权威：风格与内容约定（README.md）+ 统一生成器（make_icon.py）
 ├── LICENSE
 └── README.md
 ```

-## 发布流程（DLPilot / EDID-Viewer / SerialMate 同一套流水线）
+## 发布流程（DLPilot / EDID-Viewer / SerialMate / I2C-Lab 同一套流水线）

 ```powershell
-cd DLPilot/src                                   # 或 EDID-viewer/src、SerialMate/src
+cd DLPilot/src                                   # 或 EDID-viewer/src、SerialMate/src、I2C-Lab/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 列表按时间倒序混排于同一页面。
+每个工具独立打标签发布（`DLPilot-v*` / `EDID-Viewer-v*` / `SerialMate-v*` /
+`I2C-Lab-v*`），Release 列表按时间倒序混排于同一页面。

 ## 备注

@@ -76,4 +88,6 @@ python publish_gitea.py <工具>-v<版本>-win64.zip --insecure    # 上传 Gite
  跟进其最新版用 `git submodule update --remote gd32e230f8_firmware_merge_tool`，随本仓提交新指针
 - 两件工具的寄存器语义（0x606E 位交换 / 0x606D 整组顺序）均经 demo 板逻辑分析仪
  双色交叉实测，过程数据与规程存于上游主仓库 `doc/architecture/`
- 更新：2026-09-30
+- 全部工具图标（logo 家族：黑底 + 工具色圆角块 + 两行字）的约定与再生成见
+  [icons/README.md](icons/README.md)，统一生成器 `icons/make_icon.py`
+- 更新：2026-10-10