I2C 调试工具 —— 当前以 PySide6 原生 GUI 为实现路径，Tauri 前端为规划中的备选方案。
目标是通过合理抽象把硬件相关细节封装成统一接口，初期以 CH341 和 CH347 芯片为主，支持通用 I2C 调试与 EEPROM 芯片读写；EEPROM 型号可通过简单配置扩展。
概览
- 前端：当前为 PySide6（原生桌面）实现；Tauri（Web + 小体积后端）为未实现的规划方案。
- 后端：Python 核心库（跨前端共享），封装硬件适配层（Adapter）。
- 硬件适配器：实现统一的 I2C/EEPROM 接口，当前提供 ch341 与 ch347 适配器实现。
- 可扩展性：通过 JSON/YAML 配置文件注册 EEPROM 型号，无需改动核心代码即可新增型号。
核心目标
- 通用 I2C 调试（扫描、读写、速率配置等）。
- 通用 EEPROM 读写（支持随机读、顺序读、分页写等）。
- 通过适配器接口屏蔽底层芯片差异，便于新增芯片支持。
- 易于扩展的 EEPROM 芯片描述格式，便于用户添加新型号。
架构（简述）
- i2ctool_core/ -> Python 包，包含设备抽象、EEPROM 操作、配置加载
- adapters/ -> 各硬件适配器（ch341、ch347 等）
- ui_pyside6/ -> PySide6 前端（本地调试工具）
- ui-tauri/ -> Tauri 前端（Web UI + 后端桥接）——【未实现计划】，目录尚未创建
- configs/ -> EEPROM 型号描述文件（JSON，位于 configs/eeprom/）
硬件适配器（接口示例） 适配器应实现如下方法（示例接口，具体以代码为准）：
- open() / close()
- scan() -> list[i2c_address]
- read(device_addr, mem_addr, length) -> bytes
- write(device_addr, mem_addr, data) -> None
- set_speed(khz)
- supports_eeprom_page_write() -> bool
通过以上统一接口，上层 EEPROM 逻辑无需关心底层芯片差异（例如 CH341 与 CH347 的 API 差异由对应适配器实现）。
EEPROM 芯片描述（示例 JSON） 说明：放在 configs/eeprom/ 目录下。字段示例尽量简洁，覆盖常见 EEPROM 行为（地址宽度、页大小、总容量等）。 示例： { "id": "24c256", "name": "Atmel 24C256", "size_bytes": 32768, "address_width": 2, // 1 或 2 字节内部地址 "page_size": 64, // 页写入最大字节数 "write_cycle_ms": 5, // 写周期时间（可用于轮询等待） "notes": "Standard I2C EEPROM" }
如何新增型号（高层步骤）
- 在 configs/eeprom/ 下添加一个 JSON/YAML 文件，填写必要字段（如上示例）。
- 在 UI 中刷新型号列表或重启工具，工具会加载新增的型号。
- 如特殊芯片有非标准操作（例如特殊寻址或多片并联），可在适配器层添加小适配逻辑或扩展配置字段。
使用说明（快速上手）
- 环境搭建（唯一安装路径，要求 Python >= 3.10）
- 安装 uv（如尚未安装，见 uv 官方文档）
- 同步依赖：uv sync（依据 pyproject.toml 与 uv.lock 创建 .venv 并安装全部依赖，含 pytest 等 dev 组）
- 运行 PySide6 开发界面
- 启动：uv run python -m ui_pyside6.main
- 或运行演示：uv run python run_demo.py（命令行演示）
- 测试功能：uv run python test_gui.py（验证核心功能与 GUI 组件）
- Tauri 前端尚未实现（见“架构”中的【未实现计划】），暂无运行方式。
验收门禁（提交前检查）
- 本地运行：python scripts/check.py
- 语法级检查：python -m compileall 覆盖 i2ctool_core/、adapters/、ui_pyside6/ 及顶层脚本
- 功能冒烟检查：运行 test_gui.py
- 全部通过时退出码为 0，任一步骤失败时退出码非零；提交改动前请先运行该检查。
- CI：.github/workflows/check.yml 在 push/PR 时自动执行同一门禁（不引入额外工具链）。
开发与打包
- 在 Windows 上测试 CH341/CH347 驱动需先安装对应厂商驱动。
- 打包 PySide6：使用 PyInstaller 打包 Python 程序。
- Tauri 打包为规划方案（未实现），如后续实现则按 Tauri 官方文档执行。
调试建议
- 在调试 EEPROM 写入时使用小数据量、开启写周期等待或轮询 ACK。
- 提供“仿真模式”适配器以便没有硬件时进行 UI 功能测试。
贡献指南
- 欢迎通过 PR 提交适配器、EEPROM 配置或 UI 改进。
- 新增适配器请实现核心接口，并通过
python scripts/check.py验收门禁（含 test_gui.py 功能验证）；当前项目尚未引入自动化测试框架，该门禁为唯一机械化检查路由。
许可证
- 请在仓库根目录添加 LICENSE（例如 MIT），并在此处注明项目许可证。
联系
- 在仓库中使用 Issues 提交需求或硬件兼容性问题。