feat: HDMI-Tool 与 I2C-Inject 首版工具集

.gitignore

@@ -0,0 +1,8 @@
+# Python
+__pycache__/
+*.pyc
+
+# PyInstaller 工作目录(打包产物 exe 已直接入库, 构建中间物不入库)
+build/
+dist/
+*.spec

HDMI-Tool/README.md

@@ -0,0 +1,76 @@
+# HDMI-Tool — HDMI 源端测试工具（LT8619C/DLPC3421 转接板调试）
+
+> 更新：2026-09-03。单文件 Python GUI（`hdmi_gui.py`），另附命令行分辨率/图案工具
+> `hdmi_source.bat`。已打包版直接双击 `HDMI-Tool.exe`，无需安装 Python。
+
+---
+
+## 1. 功能总览
+
+| 功能 | 说明 |
+|---|---|
+| EDID 查看 | 枚举各显示输出口，从注册表读取 EDID 原始数据，按 EDID 1.4/CEA-861 解算：厂商/型号/尺寸/支持模式（DTD/已建立/标准/CEA-VIC）/首选时序完整参数/校验和 |
+| 分辨率切换 | 第二行"分辨率"下拉列出显卡按该屏 EDID 提供的全部模式；**应用**=临时切换（不写注册表，重启还原），**恢复**=回到本次会话切改前的模式 |
+| 测试图案 | 全屏投到所选显示器，测试卡区域可选 `640x360 / 800x600 / full 铺满`；内置 纯红/纯绿/纯蓝/棋盘格/网格线 + R/G/B 三行纯色值按钮（55/AA/FF，与 dist 下 solid_*.png 对应）+ 3 个自定义图片栏位 |
+| 命令行模式 | 自动化测试脚本可直接调用（见 §4） |
+
+## 2. 快速上手（GUI）
+
+1. 双击 `HDMI-Tool.exe`（或 `python hdmi_gui.py`，需 Python ≥3.10 + pyserial 不需要，纯标准库；自定义图片 JPG/BMP 需 Pillow）
+2. 顶部显示器下拉选择目标屏（多屏时注意别选成主屏），"刷新"重新枚举
+3. **切分辨率**：第二行选模式 → 点"应用"；测完点"恢复"
+4. **投测试图**：
+   - 先在图案按钮行右侧选**测试卡区域**（640x360 / 800x600 / full）
+   - 点图案按钮即全屏投放；按 **ESC** 退出
+   - R/G/B 三行纯色按钮（55/AA/FF）用于位交换类测试：55 与 AA 互为字节镜像对，FF 为全高基准
+   - 自定义图片：点"⚙"配置名称与图片文件（图片会复制到本目录），点栏位名投放
+5. 区域与自定义栏位配置自动保存在本目录 `pattern_slots.json`
+
+## 3. 典型场景（LT8619C demo 板测试）
+
+```
+1. HDMI 接 demo 板 → 启动 HDMI-Tool → 刷新 → 选中 demo 板显示器
+2. 分辨率切 800x600@60（demo 板 shadow EDID 首选）→ 测试卡区域选 800x600
+3. 点 R/G/B 行的纯色按钮投图 → 配合逻辑分析仪/万用表测 RGB 输出
+4. 测完"恢复"分辨率
+```
+
+## 4. 命令行模式
+
+```
+python hdmi_gui.py --dump                          控制台输出 EDID 解算（exe 版不支持）
+python hdmi_gui.py --test-pattern Blue --area 800x600 --seconds 5
+                                                   出图 5 秒自动退出
+python hdmi_gui.py --test-pattern Custom1          投自定义栏位 1
+  --area {640x360,800x600,full}  --monitor N  --seconds S
+```
+
+**hdmi_source.bat**（PowerShell 源端工具，功能与 GUI 互补）：
+
+```
+tools\hdmi_source.bat -List                        枚举显示器与支持分辨率（验证 EDID）
+tools\hdmi_source.bat -Monitor 1 -Mode 800x600     切模式
+tools\hdmi_source.bat -Mode 800x600 -Pattern -Restore
+                                                   切模式→出图案→退出后自动恢复
+```
+
+## 5. 目录内容
+
+| 文件 | 用途 |
+|---|---|
+| `HDMI-Tool.exe` | 打包好的单文件版（--noconsole；`--dump` 请用源码方式跑） |
+| `hdmi_gui.py` | 主程序源码 |
+| `build_exe.py` | 打包脚本（`python build_exe.py`，自动装 PyInstaller；`--debug` 额外出带控制台版） |
+| `hdmi_source.ps1 / .bat` | 源端分辨率/图案命令行工具 |
+| `gen_bw_patterns.py` / `gen_solid_colors.py` | 测试图生成脚本（bw 黑白系列 640x360 / solid 纯色系列 800x600） |
+| `solid_*.png` | 9 张 800x600 纯色图（R/G/B 各 55/AA/FF，供自定义栏位或脚本使用） |
+| `bw_*.png` | 5 张 640x360 黑白测试图（西门子星/频率条纹/渐变棋盘/波带/综合卡） |
+| `logos/` | 图标源文件与 `make_ico.py`（改 logo 后重跑再打包） |
+| `pattern_slots.json` | 自定义栏位 + 测试卡区域配置（运行后自动生成/更新） |
+
+## 6. 注意事项
+
+- 测试卡区域与自定义栏位配置按 exe/脚本所在目录各自保存，两份安装互不影响
+- 重打包后 Windows 图标缓存可能仍显示旧图标：`ie4uinit -show` 或改名即可
+- 多屏环境切分辨率前先确认显示器序号（下拉框中名称与 `-List` 输出一致）
+- 修改源码后重新打包前，先结束残留的 HDMI-Tool 进程（build_exe.py 会自动处理）

HDMI-Tool/build_exe.py

@@ -0,0 +1,82 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+把 hdmi_gui.py 打包成单文件 exe(工具名: HDMI-Tool)
+================================
+使用 PyInstaller --onefile --noconsole: Python 解释器 + 标准库 + tkinter
+全部打进一个 exe, 目标机器无需安装任何依赖。
+
+用法:
+  python build_exe.py            自动安装 PyInstaller(如缺)并打包
+  python build_exe.py --debug    额外打一个带控制台的变体(--dump 可用)
+
+产物: tools/dist/HDMI-Tool.exe(及 --debug 时的 HDMI-Tool-console.exe)
+首次运行 onefile exe 会先解压到临时目录, 启动比脚本慢一两秒, 属正常现象。
+"""
+
+import os
+import subprocess
+import sys
+
+BASE = os.path.dirname(os.path.abspath(__file__))
+ICO = os.path.join(BASE, 'logos', 'logo_ph_orange.ico')
+
+
+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, extra_args):
+    dist = os.path.join(BASE, 'dist')
+    work = os.path.join(BASE, 'build')
+    remove_stale(os.path.join(dist, name + '.exe'))
+    cmd = [sys.executable, '-m', 'PyInstaller',
+           '--onefile', '--clean', '--name', name,
+           '--distpath', dist, '--workpath', work, '--specpath', work,
+           ] + extra_args + [os.path.join(BASE, 'hdmi_gui.py')]
+    if os.path.exists(ICO):
+        # exe 文件图标 + 运行时窗口图标资源(从 _MEIPASS 读取)
+        cmd += ['--icon', ICO, '--add-data', f'{ICO};.']
+    else:
+        print('警告: 未找到 logos/logo_ph_orange.ico(先运行 logos/make_ico.py), 本次打包不带图标')
+    print('\n>>', ' '.join(cmd))
+    subprocess.check_call(cmd)
+    out = os.path.join(dist, name + '.exe')
+    print(f'完成: {out}  ({os.path.getsize(out) / 1024 / 1024:.1f} MB)')
+
+
+def main():
+    build_console = '--debug' in sys.argv
+    ensure_pyinstaller()
+    # 常规版: 双击即用, 无黑框(GUI/图案/自定义栏位全部可用, --dump 除外)
+    build('HDMI-Tool', ['--noconsole'])
+    if build_console:
+        # 调试版: 带控制台, --dump / 异常栈可见
+        build('HDMI-Tool-console', [])
+
+
+if __name__ == '__main__':
+    main()

HDMI-Tool/gen_bw_patterns.py

@@ -0,0 +1,185 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+生成 640x360 黑白测试图, 供 HDMI 源端工具的自定义栏位使用
+================================================================
+输出到 exe 目录(tools/dist/), 并把前 3 张写入 pattern_slots.json,
+启动 hdmi_gui 后自定义栏位即可直接点用; 其余两张可用 "⚙" 换上。
+
+图案清单(均为 640x360 黑白, 1:1 投屏无缩放):
+  bw_star.png          西门子星: 60 楔放射星, 看极限分辨率与中心偏移
+  bw_sweep.png         频率扫描条纹: 周期 24px 渐减到 3px(上竖线/下横线)
+  bw_checker_sweep.png 渐变棋盘: 格子尺寸 2px 递增到 32px 共 9 段
+  bw_zoneplate.png     同心波带片: 环距向中心递减, 看各向混叠
+  bw_testcard.png      综合测试卡: 灰阶/刻度/细棋盘/粗细线/标记
+
+用法: python gen_bw_patterns.py
+"""
+
+import json
+import math
+import os
+
+from PIL import Image, ImageDraw
+
+W, H = 640, 360
+BASE = os.path.dirname(os.path.abspath(__file__))
+OUT = os.path.join(BASE, 'dist')
+
+
+def save(img, name):
+    os.makedirs(OUT, exist_ok=True)
+    path = os.path.join(OUT, name)
+    img.save(path)
+    print(f'写出 {path}')
+
+
+def gen_star():
+    """西门子星: 60 个黑白交替楔形, 边缘楔宽约 17px, 向中心无限加密"""
+    img = Image.new('L', (W, H), 255)
+    d = ImageDraw.Draw(img)
+    cx, cy, R = W // 2, H // 2, 165
+    n = 60
+    for i in range(0, n, 2):                    # 黑楔在偶数位, 底为白
+        d.pieslice([cx - R, cy - R, cx + R, cy + R],
+                   i * 360.0 / n, (i + 1) * 360.0 / n, fill=0)
+    d.ellipse([cx - R - 6, cy - R - 6, cx + R + 6, cy + R + 6],
+              outline=0, width=3)
+    d.rectangle([0, 0, W - 1, H - 1], outline=0, width=2)
+    save(img, 'bw_star.png')
+
+
+def gen_sweep():
+    """频率扫描条纹: 左到右黑白条纹周期 24px 渐减到 3px; 上半竖线, 下半横线"""
+    img = Image.new('L', (W, H), 255)
+    px = img.load()
+    # 上半: 竖条纹
+    ph = 0.0
+    for x in range(W):
+        t = x / (W - 1)
+        ph += 1.0 / (24 - 21 * t)
+        if (ph % 1.0) < 0.5:
+            for y in range(H // 2):
+                px[x, y] = 0
+    # 下半: 横条纹
+    ph = 0.0
+    for y in range(H // 2, H):
+        t = (y - H // 2) / (H // 2 - 1)
+        ph += 1.0 / (24 - 21 * t)
+        if (ph % 1.0) < 0.5:
+            for x in range(W):
+                px[x, y] = 0
+    d = ImageDraw.Draw(img)
+    d.line([0, H // 2, W, H // 2], fill=0, width=2)
+    d.rectangle([0, 0, W - 1, H - 1], outline=0, width=2)
+    d.text((8, 6), 'H sweep 24px->3px', fill=0)
+    d.text((8, H // 2 + 6), 'V sweep 24px->3px', fill=0)
+    save(img, 'bw_sweep.png')
+
+
+def gen_checker_sweep():
+    """渐变棋盘: 格子尺寸从 2px 逐段加倍到 32px, 看多大格子开始可分辨"""
+    img = Image.new('L', (W, H), 0)
+    d = ImageDraw.Draw(img)
+    sizes = [2, 3, 4, 6, 8, 12, 16, 24, 32]
+    seg = W / len(sizes)
+    for i, s in enumerate(sizes):
+        x0, x1 = int(round(i * seg)), int(round((i + 1) * seg))
+        for yy in range(0, H, s):
+            for xx in range(x0, x1, s):
+                if ((xx // s) + (yy // s)) % 2 == 0:
+                    d.rectangle([xx, yy, min(xx + s, x1) - 1, min(yy + s, H) - 1],
+                                fill=255)
+        d.line([x1, 0, x1, H], fill=255, width=2)
+    d.text((4, 4), 'checker 2..32px', fill=255)
+    save(img, 'bw_checker_sweep.png')
+
+
+def gen_zoneplate():
+    """同心波带片: 环距中心处约 31px、边缘约 3.5px, 观察各方向混叠"""
+    img = Image.new('L', (W, H), 255)
+    px = img.load()
+    cx, cy, k = W / 2, H / 2, 0.0008
+    for y in range(H):
+        dy = y - cy
+        for x in range(W):
+            dx = x - cx
+            if math.cos(k * (dx * dx + dy * dy)) > 0:
+                px[x, y] = 0
+    d = ImageDraw.Draw(img)
+    d.rectangle([0, 0, W - 1, H - 1], outline=0, width=2)
+    save(img, 'bw_zoneplate.png')
+
+
+def gen_testcard():
+    """综合测试卡: 灰阶条 + 刻度 + 细棋盘 + 粗细线 + 角标"""
+    img = Image.new('L', (W, H), 0)
+    d = ImageDraw.Draw(img)
+
+    # 外框与 40px 刻度(边缘短刻线)
+    d.rectangle([0, 0, W - 1, H - 1], outline=255, width=2)
+    for x in range(40, W, 40):
+        d.line([x, 0, x, 10], fill=255, width=1)
+        d.line([x, H, x, H - 10], fill=255, width=1)
+    for y in range(40, H, 40):
+        d.line([0, y, 10, y], fill=255, width=1)
+        d.line([W, y, W - 10, y], fill=255, width=1)
+
+    # 顶部 16 级灰阶条
+    gw = W // 16
+    for i in range(16):
+        v = round(i * 255 / 15)
+        d.rectangle([i * gw, 20, (i + 1) * gw - 1, 44], fill=v, outline=255)
+
+    # 左下: 1px 棋盘块 (640/4=160 宽 x 72 高)
+    bx, by, bs = 16, H - 96, 2
+    for yy in range(by, by + 72, bs):
+        for xx in range(bx, bx + 160, bs):
+            if ((xx // bs) + (yy // bs)) % 2 == 0:
+                d.rectangle([xx, yy, xx + bs - 1, yy + bs - 1], fill=255)
+    d.text((bx, by - 14), '2px checker', fill=255)
+
+    # 右下: 1/2/4px 白线组(横线), 看线条再现
+    lx = W - 210
+    for row, lw in enumerate((1, 2, 4)):
+        y0 = H - 100 + row * 26
+        for off in range(0, 13, lw * 2):
+            d.line([lx, y0 + off, lx + 190, y0 + off], fill=255, width=lw)
+    d.text((lx, H - 114), '1/2/4px lines', fill=255)
+
+    # 中心十字(1px)
+    cx, cy = W // 2, H // 2
+    d.line([cx, 60, cx, H - 60], fill=255, width=1)
+    d.line([W // 4, cy, W - W // 4, cy], fill=255, width=1)
+
+    # 四角 L 标记
+    m, L = 16, 28
+    for sx, sy in ((m, m), (W - 1 - m, m), (m, H - 1 - m), (W - 1 - m, H - 1 - m)):
+        dx = -1 if sx > cx else 1
+        dy = -1 if sy > cy else 1
+        d.line([sx, sy, sx + dx * L, sy], fill=255, width=2)
+        d.line([sx, sy, sx, sy + dy * L], fill=255, width=2)
+
+    d.text((W // 2 - 60, 52), '640x360 TEST', fill=255)
+    save(img, 'bw_testcard.png')
+
+
+def write_slots():
+    slots = [
+        {'name': '西门子星', 'file': 'bw_star.png'},
+        {'name': '频率条纹', 'file': 'bw_sweep.png'},
+        {'name': '渐变棋盘', 'file': 'bw_checker_sweep.png'},
+    ]
+    path = os.path.join(OUT, 'pattern_slots.json')
+    with open(path, 'w', encoding='utf-8') as f:
+        json.dump(slots, f, ensure_ascii=False, indent=2)
+    print(f'写出 {path}(前 3 张已配入自定义栏位, 其余两张可用 "⚙" 换上)')
+
+
+if __name__ == '__main__':
+    gen_star()
+    gen_sweep()
+    gen_checker_sweep()
+    gen_zoneplate()
+    gen_testcard()
+    write_slots()

HDMI-Tool/gen_solid_colors.py

@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+生成 800x600 纯色测试图, 供 RGB 位交换(0x606E)验证使用
+================================================================
+配合 demo 板当前 EDID 首选时序 800x600@60, 全屏纯色输出。
+用法: python gen_solid_colors.py  → 输出到 tools/dist/solid_*.png
+在 HDMI-Tool 中通过自定义栏位(⚙ 换图)加载。
+"""
+
+import os
+
+from PIL import Image
+
+W, H = 800, 600          # 与 demo 板 EDID 首选时序一致, 全屏铺满
+BASE = os.path.dirname(os.path.abspath(__file__))
+OUT = os.path.join(BASE, 'dist')
+
+# (文件名后缀, RGB 值, 用途)
+COLORS = [
+    ('FF0000', (0xFF, 0x00, 0x00), '通道映射: R=D[23:16]'),
+    ('00FF00', (0x00, 0xFF, 0x00), '通道映射: G=D[15:8]'),
+    ('0000FF', (0x00, 0x00, 0xFF), '通道映射: B=D[7:0]'),
+    ('AA0000', (0xAA, 0x00, 0x00), 'R 交换检测: 0xAA(10101010)'),
+    ('550000', (0x55, 0x00, 0x00), 'R 交换检测: 0x55(01010101)'),
+    ('00AA00', (0x00, 0xAA, 0x00), 'G 交换检测'),
+    ('005500', (0x00, 0x55, 0x00), 'G 交换检测'),
+    ('0000AA', (0x00, 0x00, 0xAA), 'B 交换检测'),
+    ('000055', (0x00, 0x00, 0x55), 'B 交换检测'),
+]
+
+
+def main():
+    os.makedirs(OUT, exist_ok=True)
+    for suffix, rgb, note in COLORS:
+        img = Image.new('RGB', (W, H), rgb)
+        path = os.path.join(OUT, f'solid_{suffix}.png')
+        img.save(path)
+        print(f'写出 {path}   # {note}')
+    print(f'\n共 {len(COLORS)} 张, 分辨率 {W}x{H}(匹配 demo 板 800x600 EDID)。')
+
+
+if __name__ == '__main__':
+    main()

HDMI-Tool/hdmi_source.bat

@@ -0,0 +1,7 @@
+@echo off
+rem HDMI source test tool launcher (bypasses PowerShell execution policy)
+rem Examples:
+rem   hdmi_source.bat -List
+rem   hdmi_source.bat -Mode 640x360
+rem   hdmi_source.bat -Mode 640x360 -Pattern -Restore
+powershell -NoProfile -ExecutionPolicy Bypass -File "%~dp0hdmi_source.ps1" %*

HDMI-Tool/hdmi_source.ps1

@@ -0,0 +1,487 @@
+<#
+.SYNOPSIS
+  HDMI 源端测试工具 —— 枚举/切换输出分辨率 + 全屏测试图案
+
+.DESCRIPTION
+  配合 LT8619C(HDMI 转 RGB888)→ DLPC3421 转接板调试使用。
+
+  原理:电脑显卡通过 HDMI DDC 读取转接板 EDID 来枚举可用分辨率,
+  本脚本调用 Win32 API 完成模式枚举与切换,再用 WinForms 全屏窗口
+  输出测试图案。板载 EDID 只声明了 640x360@60(25.2MHz 像素时钟),
+  插上 HDMI 后显卡应只能发这一个模式;-List 可直接验证 EDID 是否生效。
+
+  测试图案用途:
+    Bars      100% 彩条 —— 肉眼/示波器验证 RGB 通道顺序与极性
+    GraySteps 16 级灰阶 —— 验证 RGB888 各 bit 连通性
+    Gradient  R/G/B 三段渐变 —— 验证每通道 8bit 线性度
+    Checker   黑白棋盘格 —— 验证像素时钟 PCLK 与 DE 对位
+    Grid      网格+中心十字 —— 验证像素映射/偏移/缩放
+    Red/Green/Blue/White/Black/Gray50 纯色 —— 万用表/示波器测单通道电平
+
+  全屏窗口操作:空格或→下一图案,←上一图案,ESC 退出。
+
+.EXAMPLE
+  tools\hdmi_source.bat -List
+      枚举所有活动显示器与显卡支持的分辨率(验证 EDID)
+
+.EXAMPLE
+  tools\hdmi_source.bat -Monitor 1 -Mode 640x360
+      把显示器 1 切到 640x360(缺省 60Hz,可写 640x360@60)
+
+.EXAMPLE
+  tools\hdmi_source.bat -Mode 640x360 -Pattern -Restore
+      切到 640x360 并全屏出图案,退出图案后恢复原分辨率
+
+.EXAMPLE
+  tools\hdmi_source.bat -Pattern -PatternName Checker -Seconds 5
+      当前分辨率下全屏棋盘格,5 秒后自动退出(自动化测试用)
+#>
+
+param(
+    [switch]$List,
+    [int]$Monitor = 1,
+    [string]$Mode = '',
+    [switch]$Pattern,
+    [ValidateSet('', 'Bars', 'GraySteps', 'Gradient', 'Checker', 'Grid',
+                  'Red', 'Green', 'Blue', 'White', 'Black', 'Gray50')]
+    [string]$PatternName = '',
+    [int]$Seconds = 0,
+    [switch]$Restore
+)
+
+$ErrorActionPreference = 'Stop'
+
+# ---------------- Win32 显示 API ----------------
+Add-Type -TypeDefinition @"
+using System;
+using System.Runtime.InteropServices;
+
+namespace HdmiSrc
+{
+    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
+    public struct DISPLAY_DEVICE
+    {
+        public int cb;
+        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)]  public string DeviceName;
+        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string DeviceString;
+        public int StateFlags;
+        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string DeviceID;
+        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string DeviceKey;
+    }
+
+    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)]
+    public struct DEVMODE
+    {
+        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)]  public string dmDeviceName;
+        public short dmSpecVersion;
+        public short dmDriverVersion;
+        public short dmSize;
+        public short dmDriverExtra;
+        public int   dmFields;
+        public int   dmPositionX;
+        public int   dmPositionY;
+        public int   dmDisplayOrientation;
+        public int   dmDisplayFixedOutput;
+        public short dmColor;
+        public short dmDuplex;
+        public short dmYResolution;
+        public short dmTTOption;
+        public short dmCollate;
+        [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)]  public string dmFormName;
+        public short dmLogPixels;
+        public int   dmBitsPerPel;
+        public int   dmPelsWidth;
+        public int   dmPelsHeight;
+        public int   dmDisplayFlags;
+        public int   dmDisplayFrequency;
+        public int   dmICMMethod;
+        public int   dmICMIntent;
+        public int   dmMediaType;
+        public int   dmDitherType;
+        public int   dmReserved1;
+        public int   dmReserved2;
+        public int   dmPanningWidth;
+        public int   dmPanningHeight;
+    }
+
+    public static class Native
+    {
+        [DllImport("user32.dll", CharSet = CharSet.Ansi)]
+        public static extern bool EnumDisplayDevices(string lpDevice, uint iDevNum,
+            ref DISPLAY_DEVICE lpDisplayDevice, uint dwFlags);
+
+        // PowerShell 会把 $null marshal 成空串而非 NULL,由 C# 侧保证传 NULL
+        public static bool EnumDisplayAdapters(uint iDevNum, ref DISPLAY_DEVICE lpDisplayDevice)
+        {
+            return EnumDisplayDevices(null, iDevNum, ref lpDisplayDevice, 0);
+        }
+
+        [DllImport("user32.dll", CharSet = CharSet.Ansi)]
+        public static extern bool EnumDisplaySettings(string lpszDeviceName, int iModeNum,
+            ref DEVMODE lpDevMode);
+
+        [DllImport("user32.dll", CharSet = CharSet.Ansi)]
+        public static extern int ChangeDisplaySettingsEx(string lpszDeviceName,
+            ref DEVMODE lpDevMode, IntPtr hwnd, int dwflags, IntPtr lParam);
+    }
+}
+"@
+
+# 板载 EDID 声明的目标模式,-List 时用于自检
+$TargetW = 640
+$TargetH = 360
+
+function New-DevMode {
+    $dm = New-Object HdmiSrc.DEVMODE
+    $dm.dmDeviceName = ''
+    $dm.dmFormName = ''
+    $dm.dmSize = [System.Runtime.InteropServices.Marshal]::SizeOf($dm)
+    return $dm
+}
+
+function New-DisplayDevice {
+    $dd = New-Object HdmiSrc.DISPLAY_DEVICE
+    $dd.DeviceName = ''
+    $dd.DeviceString = ''
+    $dd.DeviceID = ''
+    $dd.DeviceKey = ''
+    $dd.cb = [System.Runtime.InteropServices.Marshal]::SizeOf($dd)
+    return $dd
+}
+
+# 枚举所有"已连接到桌面"的显示器(即插着 HDMI 的输出口)
+function Get-Displays {
+    $list = @()
+    $i = 0
+    while ($true) {
+        $dd = New-DisplayDevice
+        if (-not [HdmiSrc.Native]::EnumDisplayAdapters($i, [ref]$dd)) { break }
+        # StateFlags bit0 = ATTACHED_TO_DESKTOP
+        if ($dd.StateFlags -band 0x1) {
+            $mon = New-DisplayDevice
+            [void][HdmiSrc.Native]::EnumDisplayDevices($dd.DeviceName, 0, [ref]$mon, 0)
+            $list += [pscustomobject]@{
+                Index    = $list.Count + 1
+                Device   = $dd.DeviceName
+                Adapter  = $dd.DeviceString
+                MonName  = $mon.DeviceString
+            }
+        }
+        $i++
+    }
+    return $list
+}
+
+# 显卡枚举到的全部显示模式(去重)
+function Get-Modes {
+    param([string]$Device)
+    $modes = @()
+    $i = 0
+    while ($true) {
+        $dm = New-DevMode
+        if (-not [HdmiSrc.Native]::EnumDisplaySettings($Device, $i, [ref]$dm)) { break }
+        $modes += [pscustomobject]@{
+            W   = $dm.dmPelsWidth
+            H   = $dm.dmPelsHeight
+            Hz  = $dm.dmDisplayFrequency
+            Bpp = $dm.dmBitsPerPel
+        }
+        $i++
+    }
+    return ($modes | Sort-Object W, H, Hz, Bpp -Unique)
+}
+
+function Get-CurrentDevMode {
+    param([string]$Device)
+    $dm = New-DevMode
+    [void][HdmiSrc.Native]::EnumDisplaySettings($Device, -1, [ref]$dm)  # ENUM_CURRENT_SETTINGS
+    return $dm
+}
+
+# 应用一个 DEVMODE(先 CDS_TEST 再真正生效),返回 $true/$false
+function Set-DevMode {
+    param([string]$Device, $dm)
+    $dm.dmFields = 0x00040000 -bor 0x00080000 -bor 0x00100000 -bor 0x00400000
+    # DM_BITSPERPEL | DM_PELSWIDTH | DM_PELSHEIGHT | DM_DISPLAYFREQUENCY
+    $rc = [HdmiSrc.Native]::ChangeDisplaySettingsEx($Device, [ref]$dm, [IntPtr]::Zero, 2, [IntPtr]::Zero)
+    if ($rc -ne 0) {
+        Write-Host ("  错误: 显卡拒绝该模式 (CDS_TEST 返回 {0})" -f $rc) -ForegroundColor Red
+        return $false
+    }
+    $rc = [HdmiSrc.Native]::ChangeDisplaySettingsEx($Device, [ref]$dm, [IntPtr]::Zero, 0, [IntPtr]::Zero)
+    if ($rc -ne 0) {
+        Write-Host ("  错误: 模式应用失败 (返回 {0})" -f $rc) -ForegroundColor Red
+        return $false
+    }
+    return $true
+}
+
+# 在显卡枚举的模式里找 W x H [@Hz] 并切换
+function Switch-Mode {
+    param([string]$Device, [int]$W, [int]$H, [int]$Hz)
+    $all = @(Get-Modes $Device)
+    $hit = @($all | Where-Object { $_.W -eq $W -and $_.H -eq $H -and ($Hz -le 0 -or $_.Hz -eq $Hz) })
+    if (-not $hit) {
+        Write-Host ("  错误: 显卡未枚举到 {0}x{1} 模式" -f $W, $H) -ForegroundColor Red
+        Write-Host "  可能原因:" -ForegroundColor Yellow
+        Write-Host "    1. 转接板 EDID 未被读取(检查 HPD / DDC / LT8619C 供电)"
+        Write-Host "    2. EDID 中未包含该分辨率(当前板载 EDID 只有 640x360@60)"
+        Write-Host "    3. 显卡驱动拒收该 DTD(可用 CRU 手动添加自定义分辨率)"
+        Write-Host "  先运行 -List 查看显卡实际枚举到了哪些模式。"
+        return $false
+    }
+    $dm = New-DevMode
+    $dm.dmPelsWidth = $W
+    $dm.dmPelsHeight = $H
+    $dm.dmDisplayFrequency = $hit[0].Hz
+    $dm.dmBitsPerPel = 32
+    $ok = Set-DevMode $Device $dm
+    if ($ok) {
+        Write-Host ("  已切换 {0} -> {1}x{2}@{3}" -f $Device, $W, $H, $hit[0].Hz) -ForegroundColor Green
+    }
+    return $ok
+}
+
+# ---------------- 全屏测试图案 ----------------
+function Show-PatternWindow {
+    param(
+        [string]$Device = '',
+        [string]$StartPattern = '',
+        [int]$AutoSeconds = 0
+    )
+
+    Add-Type -AssemblyName System.Windows.Forms
+    Add-Type -AssemblyName System.Drawing
+
+    # 窗口放到目标设备名对应的屏幕上(如 \\.\DISPLAY2),找不到则回退主屏
+    $screen = [System.Windows.Forms.Screen]::AllScreens |
+        Where-Object { $_.DeviceName -eq $Device } |
+        Select-Object -First 1
+    if (-not $screen) { $screen = [System.Windows.Forms.Screen]::PrimaryScreen }
+
+    $script:patterns = @('Bars', 'GraySteps', 'Gradient', 'Checker', 'Grid',
+                         'Red', 'Green', 'Blue', 'White', 'Black', 'Gray50')
+    $script:pi = 0
+    if ($StartPattern) {
+        $idx = [array]::IndexOf($script:patterns, $StartPattern)
+        if ($idx -ge 0) { $script:pi = $idx }
+    }
+
+    $script:form = New-Object System.Windows.Forms.Form
+    $script:form.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::None
+    $script:form.StartPosition = [System.Windows.Forms.FormStartPosition]::Manual
+    $script:form.Bounds = $screen.Bounds
+    $script:form.TopMost = $true
+    $script:form.KeyPreview = $true
+    # 双缓冲避免棋盘格/网格闪烁
+    $script:form.GetType().GetProperty('DoubleBuffered',
+        [System.Reflection.BindingFlags]'Instance,NonPublic').SetValue($script:form, $true, $null)
+
+    $osdFont = New-Object System.Drawing.Font('Consolas', 11)
+
+    $paintHandler = {
+        param($s, $e)
+        $g = $e.Graphics
+        $w = $e.ClipRectangle.Width
+        $h = $e.ClipRectangle.Height
+        $name = $script:patterns[$script:pi]
+
+        switch ($name) {
+            'Bars' {
+                # 100% 饱和度竖彩条:白黄青绿品红红蓝黑
+                $c = @(@(255,255,255), @(255,255,0), @(0,255,255), @(0,255,0),
+                        @(255,0,255), @(255,0,0), @(0,0,255), @(0,0,0))
+                $n = $c.Count
+                for ($k = 0; $k -lt $n; $k++) {
+                    $bw = [Math]::Ceiling($w / $n)
+                    $brush = New-Object System.Drawing.SolidBrush (
+                        [System.Drawing.Color]::FromArgb($c[$k][0], $c[$k][1], $c[$k][2]))
+                    $g.FillRectangle($brush, [int]($k * $bw), 0, [int]$bw + 1, $h)
+                    $brush.Dispose()
+                }
+            }
+            'GraySteps' {
+                # 16 级灰阶,验证 RGB888 各 bit
+                $n = 16
+                for ($k = 0; $k -lt $n; $k++) {
+                    $v = [int]($k * 255 / ($n - 1))
+                    $bw = [Math]::Ceiling($w / $n)
+                    $brush = New-Object System.Drawing.SolidBrush (
+                        [System.Drawing.Color]::FromArgb($v, $v, $v))
+                    $g.FillRectangle($brush, [int]($k * $bw), 0, [int]$bw + 1, $h)
+                    $brush.Dispose()
+                }
+            }
+            'Gradient' {
+                # R/G/B 三段水平渐变,验证每通道 8bit 线性度
+                $seg = [Math]::Ceiling($w / 3.0)
+                $rgbIdx = @(0, 1, 2)
+                foreach ($ch in $rgbIdx) {
+                    for ($x = 0; $x -lt $seg; $x++) {
+                        $v = [int](255 * $x / [Math]::Max(1.0, ($seg - 1)))
+                        $r = 0; $gg = 0; $b = 0
+                        if ($ch -eq 0) { $r = $v } elseif ($ch -eq 1) { $gg = $v } else { $b = $v }
+                        $brush = New-Object System.Drawing.SolidBrush (
+                            [System.Drawing.Color]::FromArgb($r, $gg, $b))
+                        $g.FillRectangle($brush, [int]($ch * $seg + $x), 0, 1, $h)
+                        $brush.Dispose()
+                    }
+                }
+            }
+            'Checker' {
+                # 黑白棋盘格,验证 PCLK/DE 对位
+                $g.FillRectangle([System.Drawing.Brushes]::Black, 0, 0, $w, $h)
+                $cell = 16
+                for ($y = 0; $y -lt $h; $y += $cell) {
+                    for ($x = 0; $x -lt $w; $x += $cell) {
+                        if ((([int]($x / $cell) + [int]($y / $cell)) % 2) -eq 0) {
+                            $g.FillRectangle([System.Drawing.Brushes]::White, $x, $y, $cell, $cell)
+                        }
+                    }
+                }
+            }
+            'Grid' {
+                # 黑底 + 40px 网格 + 中心十字 + 白色边框,验证像素映射
+                $g.FillRectangle([System.Drawing.Brushes]::Black, 0, 0, $w, $h)
+                $pen = New-Object System.Drawing.Pen ([System.Drawing.Color]::FromArgb(0, 128, 0), 1)
+                for ($x = 40; $x -lt $w; $x += 40) { $g.DrawLine($pen, $x, 0, $x, $h) }
+                for ($y = 40; $y -lt $h; $y += 40) { $g.DrawLine($pen, 0, $y, $w, $y) }
+                $pen.Dispose()
+                $wp = New-Object System.Drawing.Pen ([System.Drawing.Color]::White, 2)
+                $cx = [int]($w / 2); $cy = [int]($h / 2)
+                $g.DrawLine($wp, $cx, 0, $cx, $h)
+                $g.DrawLine($wp, 0, $cy, $w, $cy)
+                $g.DrawRectangle($wp, 1, 1, $w - 3, $h - 3)
+                $wp.Dispose()
+            }
+            'Red'   { $g.FillRectangle([System.Drawing.Brushes]::Red,   0, 0, $w, $h) }
+            'Green' { $g.FillRectangle([System.Drawing.Brushes]::Green, 0, 0, $w, $h) }
+            'Blue'  { $g.FillRectangle([System.Drawing.Brushes]::Blue,  0, 0, $w, $h) }
+            'White' { $g.FillRectangle([System.Drawing.Brushes]::White, 0, 0, $w, $h) }
+            'Black' { $g.FillRectangle([System.Drawing.Brushes]::Black, 0, 0, $w, $h) }
+            'Gray50' {
+                $brush = New-Object System.Drawing.SolidBrush (
+                    [System.Drawing.Color]::FromArgb(128, 128, 128))
+                $g.FillRectangle($brush, 0, 0, $w, $h)
+                $brush.Dispose()
+            }
+        }
+
+        # 左上角 OSD:图案名 + 分辨率 + 按键提示
+        $text = "[{0}]  {1}x{2}    空格/→:下一图案  ←:上一图案  ESC:退出" -f $name, $w, $h
+        $sz = $g.MeasureString($text, $osdFont)
+        $bg = New-Object System.Drawing.SolidBrush ([System.Drawing.Color]::FromArgb(150, 0, 0, 0))
+        $g.FillRectangle($bg, 6, 6, $sz.Width + 12, $sz.Height + 8)
+        $bg.Dispose()
+        $g.DrawString($text, $osdFont, [System.Drawing.Brushes]::White, 12, 10)
+    }
+    $script:form.Add_Paint($paintHandler)
+
+    $script:form.Add_KeyDown({
+        param($s, $e)
+        switch ($e.KeyCode) {
+            'Escape' { $s.Close() }
+            'Space'  { $script:pi = ($script:pi + 1) % $script:patterns.Count; $s.Invalidate() }
+            'Right'  { $script:pi = ($script:pi + 1) % $script:patterns.Count; $s.Invalidate() }
+            'Left'   { $script:pi = ($script:pi - 1 + $script:patterns.Count) % $script:patterns.Count; $s.Invalidate() }
+        }
+    })
+
+    $script:form.Add_Activated({ [System.Windows.Forms.Cursor]::Hide() })
+    $script:form.Add_FormClosed({ [System.Windows.Forms.Cursor]::Show() })
+
+    if ($AutoSeconds -gt 0) {
+        $timer = New-Object System.Windows.Forms.Timer
+        $timer.Interval = $AutoSeconds * 1000
+        $timer.Add_Tick({ $script:form.Close() })
+        $timer.Start()
+    }
+
+    Write-Host ("全屏图案已启动于 {0} ({1}x{2})" -f $screen.DeviceName, $screen.Bounds.Width, $screen.Bounds.Height)
+    Write-Host "空格/→:下一图案  ←:上一图案  ESC:退出"
+    [void]$script:form.ShowDialog()
+}
+
+function Show-Usage {
+    Write-Host @"
+用法:
+  hdmi_source.bat -List                                  枚举显示器与可用分辨率(验证 EDID)
+  hdmi_source.bat -Monitor <n> -Mode <WxH[@Hz]>          切换分辨率, 如 -Mode 640x360 或 640x360@60
+  hdmi_source.bat [-Monitor <n>] -Pattern [-PatternName <名>] [-Seconds <n>]
+                                                         全屏测试图案(Bar/GraySteps/Gradient/Checker/Grid/纯色)
+  可选: -Restore  退出图案窗口后恢复切换前的分辨率
+        -Seconds <n>  图案 n 秒后自动退出(自动化测试)
+
+典型调试流程:
+  1. HDMI 插上转接板 -> -List 确认出现 640x360(EDID 生效)
+  2. -Mode 640x360 -Pattern -> 全屏图案, 逐项验证 RGB 通道/位序/像素映射
+"@
+}
+
+# ---------------- 主流程 ----------------
+$displays = @(Get-Displays)   # @() 保证单显示器时不退化为标量
+if ($displays.Count -eq 0) {
+    Write-Host "错误: 未找到活动显示器" -ForegroundColor Red
+    exit 1
+}
+
+if ($List) {
+    foreach ($d in $displays) {
+        Write-Host ""
+        Write-Host ("== 显示器 {0}  {1}  显卡[{2}]  监视器[{3}]" -f $d.Index, $d.Device, $d.Adapter, $d.MonName) -ForegroundColor Cyan
+        $cur = Get-CurrentDevMode $d.Device
+        Write-Host ("   当前模式: {0}x{1}@{2}  {3}bpp" -f $cur.dmPelsWidth, $cur.dmPelsHeight, $cur.dmDisplayFrequency, $cur.dmBitsPerPel)
+        $modes = Get-Modes $d.Device
+        $modes | Format-Table W, H, Hz, Bpp -AutoSize
+        $hasTarget = $modes | Where-Object { $_.W -eq $TargetW -and $_.H -eq $TargetH }
+        if ($hasTarget) {
+            Write-Host ("   [OK] 找到板载 EDID 目标模式 {0}x{1} -> EDID 已被显卡读取" -f $TargetW, $TargetH) -ForegroundColor Green
+        } else {
+            Write-Host ("   [--] 未找到 {0}x{1} (若此口接的是转接板, 说明 EDID/HPD 未生效)" -f $TargetW, $TargetH) -ForegroundColor Yellow
+        }
+    }
+    exit 0
+}
+
+if (-not $Mode -and -not $Pattern) {
+    Show-Usage
+    exit 0
+}
+
+if ($Monitor -gt $displays.Count) {
+    Write-Host ("错误: -Monitor 超出范围(共 {0} 个活动显示器, 运行 -List 查看)" -f $displays.Count) -ForegroundColor Red
+    exit 1
+}
+$disp = $displays[$Monitor - 1]
+Write-Host ("目标: 显示器 {0} = {1}" -f $disp.Index, $disp.Device)
+
+$prevMode = $null
+if ($Mode) {
+    if ($Mode -notmatch '^\s*(\d+)\s*[xX]\s*(\d+)\s*(?:@\s*(\d+)\s*)?$') {
+        Write-Host "错误: -Mode 格式应为 WxH 或 WxH@Hz, 例如 640x360 或 640x360@60" -ForegroundColor Red
+        exit 1
+    }
+    $w = [int]$Matches[1]; $h = [int]$Matches[2]
+    $hz = 0
+    if ($Matches[3]) { $hz = [int]$Matches[3] }
+
+    $prevMode = Get-CurrentDevMode $disp.Device
+    $ok = Switch-Mode $disp.Device $w $h $hz
+    if (-not $ok) { exit 1 }
+    Start-Sleep -Milliseconds 300   # 等显卡/显示器完成模式切换
+}
+
+if ($Pattern) {
+    if ($Restore -and -not $prevMode) {
+        Write-Host "提示: -Restore 仅在与 -Mode 同用时生效" -ForegroundColor Yellow
+    }
+    try {
+        Show-PatternWindow -Device $disp.Device -StartPattern $PatternName -AutoSeconds $Seconds
+    }
+    finally {
+        if ($Restore -and $prevMode) {
+            Write-Host ("恢复原分辨率 {0}x{1}@{2} ..." -f $prevMode.dmPelsWidth, $prevMode.dmPelsHeight, $prevMode.dmDisplayFrequency)
+            [void](Set-DevMode $disp.Device $prevMode)
+        }
+    }
+}

HDMI-Tool/logos/logo_ph_orange.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" fill="#000000"/>
+  <rect x="38" y="64" width="436" height="186" rx="34" fill="#FF9900"/>
+  <text x="256" y="210" font-family="Arial, 'Microsoft YaHei', sans-serif" font-size="146" font-weight="900" fill="#000000" text-anchor="middle">HDMI</text>
+  <text x="256" y="421" font-family="Arial, 'Microsoft YaHei', sans-serif" font-size="146" font-weight="900" fill="#FFFFFF" text-anchor="middle">Tool</text>
+</svg>

HDMI-Tool/logos/make_ico.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+把 logo_ph_orange.svg 同款设计栅格化为多尺寸 .ico(供 exe 图标)
+================================================================
+设计参数与 SVG 严格一致: 黑底 512, 橙色圆角矩形 x38 y64 w436 h186 rx34,
+HDMI 146px Arial Bold 黑字(框内居中), Tool 146px 白字(基线 421)。
+
+输出: logos/logo_ph_orange.png(512, 预览/复用)
+      logos/logo_ph_orange.ico(16~256 七档, exe 图标用)
+
+用法: python make_ico.py
+"""
+
+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 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=(255, 153, 0))
+    if not os.path.exists(FONT):
+        raise SystemExit(f'未找到字体 {FONT}, 无法栅格化')
+    f = ImageFont.truetype(FONT, max(8, round(146 * s)))
+    cx = size / 2
+    # HDMI: 居中于橙色框
+    d.text((cx, 64 * s + 186 * s / 2), 'HDMI', font=f, fill=(0, 0, 0), anchor='mm')
+    # Tool: 与 SVG 基线 421 对齐(无下伸字母, 中心 = 421 - cap/2 ~= 368)
+    d.text((cx, 368 * s), 'Tool', font=f, fill=(255, 255, 255), anchor='mm')
+    return img
+
+
+if __name__ == '__main__':
+    img = render(512)
+    png = os.path.join(BASE, 'logo_ph_orange.png')
+    ico = os.path.join(BASE, 'logo_ph_orange.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}')

HDMI-Tool/pattern_slots.json

@@ -0,0 +1,17 @@
+{
+  "area": "800x600",
+  "slots": [
+    {
+      "name": "西门子星",
+      "file": "bw_star.png"
+    },
+    {
+      "name": "频率条纹",
+      "file": "bw_sweep.png"
+    },
+    {
+      "name": "渐变棋盘",
+      "file": "bw_checker_sweep.png"
+    }
+  ]
+}

I2C-Inject/README.md

@@ -0,0 +1,70 @@
+# I2C-Inject — LT8619C 寄存器择机注入工具
+
+> 更新：2026-09-03。由两部分组成：**RP2040 注入器固件**（`rp2040_inject.py`，刷入
+> BPI-Pico-RP2040，MicroPython）+ **PC 端 GUI**（`i2c_inject_gui.py` / 打包版
+> `I2C-Inject.exe`）。可在 LT8619C demo 板的 I2C 总线上安全地在线读写寄存器。
+
+---
+
+## 1. 工作原理（为什么不会和 demo 板冲突）
+
+demo 板 MCU 每 ~500ms 轮询一次 LT8619C。注入器的时序：
+
+```
+监听总线边沿 -> 等下一轮活动结束 -> 总线静置 50ms -> 发射
+(切 bank -> 写 -> 读回校验), 失败自动重试 3 次 -> 立即释放总线回监听
+```
+
+静置窗口落在两次轮询之间的 ~490ms 空窗内，单次注入序列 <2ms，冲突概率趋近零；
+即使撞上也表现为读回不符，自动重试覆盖。板载 LED：**常亮 = 监听中**，上电快闪 3 次 = 自检。
+
+## 2. 硬件准备
+
+| RP2040 板 | 接 LT8619C 总线 |
+|---|---|
+| GP8（物理脚 11） | SDA |
+| GP9（物理脚 12） | SCL |
+| GND | GND |
+
+- **不接 VCC、不外加干扰**：总线由 demo 板自带上拉（先确认上拉为 3.3V）
+- 固件刷写：板子插 USB → 已有 MicroPython 则直接
+  `py -m pip install mpremote && py -m mpremote connect COMx cp rp2040_inject.py :main.py`
+  → 复位后自启动（刷新 MicroPython UF2 会清掉 main.py，重传一次即可）
+- 固件内置 viper 编译的总线嗅探（`c [ms]` 命令，~3MHz 采样），串口回吐边沿数据可离线解码 I2C
+
+## 3. GUI 使用
+
+双击 `I2C-Inject.exe`（或 `python i2c_inject_gui.py [COMx]`）：
+
+1. **第一排左侧**：串口下拉 →"刷新"扫描 → 选中注入器端口 →"连接"（日志出现"已连接"）
+2. **第一排右侧**：输入 Bank/寄存器/值（十六进制）→ **写入**（自动读回校验）/**读取**
+3. **0x606E 快捷块**（位交换，语义为 demo 板 LA 实测）：
+   - `00`=关交换；`20`=镜像 D[7:0]（载蓝色分量的组，实测立即生效）
+   - `40`/`80`=另外两组（demo 板未单独实测，自板点亮时验证）
+4. **0x606D 快捷块**（RGB 整组顺序，蓝+红双色实测=手册 naive 读法）：
+   - `00 BGR / 03 BRG / 04 GBR / 05 GRB / 06 RBG / 07 RGB`
+   - 字母串顺序 = D[23:16]/D[15:8]/D[7:0] 携带的分量；切换实时生效，不影响 HDMI 锁定
+5. 回显格式：`=` 正常结果（绿色，含"读回=xx"校验值）、`!` 告警/失败（橙色）
+6. 收尾：把改过的寄存器写回原值（0x606E 原值 00；0x606D 原值 07）
+
+## 4. 已实测的寄存器事实速查（demo 板）
+
+| 寄存器 | 实测结论 |
+|---|---|
+| 0x606E | bit5(0x20)=镜像 D[7:0]（蓝值组），立即生效、含消隐码；bit7(0x80) 对该组无效；稳态下写入可持续（实测 6.7s+），板子非稳态时 0.3~0.5s 内被刷回 00 → **先投图等稳态再写，写完立即读回确认** |
+| 0x606D | 000/001/010=BGR、011=BRG、100=GBR、101=GRB、110=RBG、111=RGB（字母串=D[23:16]/D[15:8]/D[7:0]），切换实时生效；demo 板 init 值 07 |
+
+## 5. 目录内容
+
+| 文件 | 用途 |
+|---|---|
+| `I2C-Inject.exe` | 打包好的单文件 PC 端 GUI（需 pyserial，已打包在内） |
+| `i2c_inject_gui.py` | PC 端 GUI 源码（`python build_exe.py` 重新打包） |
+| `rp2040_inject.py` | RP2040 注入器固件（MicroPython，刷成 main.py 自启动） |
+| `logos/` | 图标源文件与 `make_ico_i2c.py`（改 logo 后重跑再打包） |
+
+## 6. 故障排查
+
+- 写入回显 `OK 读回=xx` 但稍后读回变了 → demo 板把它刷回了（见 §4 稳态提醒），先确认 HDMI 已稳定出图
+- 读寄存器 NAK/失败 → 检查三根接线与共地；用 `s` 命令看边沿计数是否在增长（增长=监听正常，总线有活动）
+- 串口列表空白 → 换 USB 口/检查设备管理器（应出现 `USB 串行设备`，VID_2E8A）

I2C-Inject/build_exe.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+把 i2c_inject_gui.py 打包成单文件 exe(工具名: I2C-Inject)
+================================
+使用 PyInstaller --onefile --noconsole, 目标机器无需安装 Python/pyserial。
+
+用法:
+  python build_exe.py        自动安装 PyInstaller(如缺)并打包
+
+产物: 本目录 dist/I2C-Inject.exe
+"""
+
+import os
+import subprocess
+import sys
+
+BASE = os.path.dirname(os.path.abspath(__file__))
+ICO = os.path.join(BASE, 'logos', 'logo_i2c_orange.ico')
+
+
+def ensure_pyinstaller():
+    try:
+        import PyInstaller  # noqa: F401
+        return
+    except ImportError:
+        pass
+    print('PyInstaller 未安装, 正在安装...')
+    subprocess.check_call([sys.executable, '-m', 'pip', 'install', 'pyinstaller'])
+
+
+def main():
+    ensure_pyinstaller()
+    exe = os.path.join(BASE, 'dist', 'I2C-Inject.exe')
+    if os.path.exists(exe):
+        try:
+            os.remove(exe)
+        except PermissionError:
+            subprocess.run(['taskkill', '/F', '/IM', 'I2C-Inject.exe'],
+                           capture_output=True)
+            import time
+            time.sleep(1.0)
+            os.remove(exe)
+    cmd = [sys.executable, '-m', 'PyInstaller',
+           '--onefile', '--clean', '--name', 'I2C-Inject',
+           '--distpath', os.path.join(BASE, 'dist'),
+           '--workpath', os.path.join(BASE, 'build'),
+           '--specpath', os.path.join(BASE, 'build'),
+           '--noconsole', os.path.join(BASE, 'i2c_inject_gui.py')]
+    if os.path.exists(ICO):
+        # exe 文件图标 + 运行时窗口图标资源(从 _MEIPASS 读取)
+        cmd += ['--icon', ICO, '--add-data', f'{ICO};.']
+    else:
+        print('警告: 未找到 logos/logo_i2c_orange.ico(先运行 logos/make_ico_i2c.py), 本次打包不带图标')
+    print('>>', ' '.join(cmd))
+    subprocess.check_call(cmd)
+    print('完成: %s  (%.1f MB)' % (exe, os.path.getsize(exe) / 1024 / 1024))
+
+
+if __name__ == '__main__':
+    main()

I2C-Inject/i2c_inject_gui.py

@@ -0,0 +1,272 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+I2C-Inject — LT8619C 寄存器择机注入工具
+================================================
+配合 RP2040 注入器固件(tools/rp2040_inject.py, 刷入 BPI-Pico-RP2040)使用,
+在 LT8619C demo 板的 I2C 总线上择机读写寄存器。
+
+特性:
+  - 串口选择/连接 与 寄存器操作 并列第一排, 手动输入 bank/寄存器/值 即刻注入
+  - 择机机制: 等总线一轮活动结束 -> 总线静置 50ms -> 发射(切bank->写->读回校验),
+    失败自动重试 3 次, 完成后立即释放总线回监听
+  - 0x606E(位交换)/0x606D(整组顺序) 快捷按钮, 全部为 demo 板 LA 实测确认的语义
+
+依赖: pyserial(py -m pip install pyserial) + tkinter 标准库
+用法: python i2c_inject_gui.py        (也可带默认串口参数: python i2c_inject_gui.py COM9)
+打包: python build_exe.py             (生成 I2C-Inject.exe)
+"""
+
+import serial
+import serial.tools.list_ports
+import os
+import sys
+import threading
+import queue
+import time
+import tkinter as tk
+from tkinter import ttk, messagebox
+
+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__))
+
+
+def get_icon_path():
+    """工具图标: 源码模式取 logos/ 下, 打包模式取 exe 内嵌资源(_MEIPASS)"""
+    if getattr(sys, 'frozen', False):
+        p = os.path.join(getattr(sys, '_MEIPASS', ''), 'logo_i2c_orange.ico')
+    else:
+        p = os.path.join(BASE_DIR, 'logos', 'logo_i2c_orange.ico')
+    return p if os.path.exists(p) else None
+
+
+class Injector:
+    """串口工作线程: 目标端口动态切换; 命令队列 -> RP2040, 回显 -> 消息队列"""
+
+    def __init__(self, on_line, on_status):
+        self.q = queue.Queue()
+        self.on_line, self.on_status = on_line, on_status
+        self._target = None          # 想要连接的端口名(None=断开)
+        self.ser = None
+        self._lock = threading.Lock()
+        threading.Thread(target=self._run, daemon=True).start()
+
+    def connect(self, port):
+        with self._lock:
+            self._target = port
+
+    def disconnect(self):
+        with self._lock:
+            self._target = None
+
+    def send(self, cmd):
+        with self._lock:
+            if self.ser is None:
+                self.on_status('未连接串口, 命令被丢弃: ' + cmd)
+                return
+        self.q.put(cmd)
+
+    def is_connected(self):
+        with self._lock:
+            return self.ser is not None
+
+    def _run(self):
+        buf = b''
+        while True:
+            with self._lock:
+                target = self._target
+            if target != (self.ser.port if self.ser else None):
+                if self.ser is not None:
+                    try:
+                        self.ser.close()
+                    except Exception:
+                        pass
+                    self.ser = None
+                    self.on_status('已断开')
+                if target:
+                    try:
+                        self.ser = serial.Serial(target, timeout=0.2)
+                        buf = b''
+                        time.sleep(0.3)          # 等 Pico 复位横幅打完
+                        self.ser.reset_input_buffer()
+                        self.on_status('已连接 ' + target)
+                    except Exception as e:
+                        self.ser = None
+                        with self._lock:
+                            self._target = None
+                        self.on_status('连接 %s 失败: %s' % (target, e))
+            if self.ser is not None:
+                try:
+                    cmd = None
+                    try:
+                        cmd = self.q.get_nowait()
+                    except queue.Empty:
+                        pass
+                    if cmd is not None:
+                        self.ser.write((cmd + '\n').encode())
+                    buf += self.ser.read(256)
+                    while b'\n' in buf:
+                        ln, buf = buf.split(b'\n', 1)
+                        txt = ln.decode('utf-8', 'replace').strip()
+                        if txt:
+                            self.on_line(txt)
+                except OSError:
+                    self.ser = None
+                    with self._lock:
+                        self._target = None
+                    self.on_status('串口丢失(设备拔出?), 请重新连接')
+            time.sleep(0.02)
+
+
+def run_gui(default_port=None):
+    root = tk.Tk()
+    root.title('I2C-Inject — LT8619C 寄存器择机注入器 (静置50ms)')
+    root.geometry('860x520')
+    ic = get_icon_path()
+    if ic:
+        try:
+            root.iconbitmap(ic)      # 窗口标题栏图标
+        except Exception:
+            pass
+
+    log_q = queue.Queue()
+
+    # ============ 第一排: 串口选择 + 寄存器操作(并列) ============
+    row1 = ttk.LabelFrame(root, text='连接与寄存器操作 (十六进制)', padding=(8, 4))
+    row1.pack(fill='x', padx=8, pady=(8, 4))
+
+    # --- 左半: 串口选择 ---
+    ttk.Label(row1, text='串口:').grid(row=0, column=0)
+    cbo_port = ttk.Combobox(row1, state='readonly', width=8, values=[])
+    cbo_port.grid(row=0, column=1, padx=(2, 6))
+
+    inj = Injector(on_line=lambda s: log_q.put((s, 'rx')),
+                   on_status=lambda s: log_q.put((s, 'st')))
+
+    def refresh_ports():
+        ports = [p.device for p in serial.tools.list_ports.comports()]
+        cbo_port['values'] = ports
+        if ports:
+            cbo_port.current(0)
+        else:
+            cbo_port.set('')
+        inj.on_status('串口列表: %s' % (', '.join(ports) if ports else '无'))
+
+    def toggle_connect():
+        if inj.is_connected():
+            inj.disconnect()
+            btn_conn.config(text='连接')
+        else:
+            port = cbo_port.get().strip()
+            if not port:
+                messagebox.showerror('未选择串口', '请先选择串口(或点刷新扫描)')
+                return
+            inj.connect(port)
+            btn_conn.config(text='断开')
+
+    ttk.Button(row1, text='刷新', width=6, command=refresh_ports).grid(row=0, column=2, padx=(0, 4))
+    btn_conn = ttk.Button(row1, text='连接', width=6, command=toggle_connect)
+    btn_conn.grid(row=0, column=3, padx=(0, 14))
+
+    # --- 右半: 寄存器操作 ---
+    ttk.Label(row1, text='Bank:').grid(row=0, column=4)
+    e_bank = ttk.Entry(row1, width=5); e_bank.insert(0, '60'); e_bank.grid(row=0, column=5, padx=(2, 8))
+    ttk.Label(row1, text='寄存器:').grid(row=0, column=6)
+    e_reg = ttk.Entry(row1, width=5); e_reg.insert(0, '6E'); e_reg.grid(row=0, column=7, padx=(2, 8))
+    ttk.Label(row1, text='值:').grid(row=0, column=8)
+    e_val = ttk.Entry(row1, width=5); e_val.insert(0, '00'); e_val.grid(row=0, column=9, padx=(2, 8))
+
+    def _hex_ok(s):
+        try:
+            return 0 <= int(s, 16) <= 0xFF
+        except ValueError:
+            return False
+
+    def do_write():
+        b, r, v = e_bank.get().strip(), e_reg.get().strip(), e_val.get().strip()
+        if not (_hex_ok(b) and _hex_ok(r) and _hex_ok(v)):
+            messagebox.showerror('输入错误', 'bank/寄存器/值 都必须是 00-FF 的十六进制')
+            return
+        inj.send('w %s %s %s' % (b, r, v))
+
+    def do_read():
+        b, r = e_bank.get().strip(), e_reg.get().strip()
+        if not (_hex_ok(b) and _hex_ok(r)):
+            messagebox.showerror('输入错误', 'bank/寄存器 必须是 00-FF 的十六进制')
+            return
+        inj.send('r %s %s' % (b, r))
+
+    ttk.Button(row1, text='写入', width=8, command=do_write).grid(row=0, column=10, padx=2)
+    ttk.Button(row1, text='读取', width=8, command=do_read).grid(row=0, column=11, padx=2)
+    ttk.Label(row1, text='写=择机写入后自动读回校验; 失败自动重试3次',
+              foreground='#666666').grid(row=1, column=0, columnspan=12,
+                                         sticky='w', pady=(4, 0))
+
+    # ============ 0x606E 快捷块(位交换) ============
+    qk = ttk.LabelFrame(root, text='0x606E 快捷操作 (位交换)', padding=(8, 4))
+    qk.pack(fill='x', padx=8, pady=4)
+    for i, v in enumerate(('00', '20', '40', '80')):
+        ttk.Button(qk, text='写 ' + v, width=8,
+                   command=lambda v=v: (e_val.delete(0, 'end'), e_val.insert(0, v), do_write())
+                   ).grid(row=0, column=i, padx=4)
+    ttk.Button(qk, text='读 0x606E', width=10,
+               command=do_read).grid(row=0, column=5, padx=4)
+    ttk.Label(qk, text='00=关交换  20=镜像D[7:0](LA实测)  40/80=另外两组(待自板单测)',
+              foreground='#666666').grid(row=1, column=0, columnspan=7,
+                                         sticky='w', pady=(3, 0))
+
+    # ============ 0x606D 快捷块(整组顺序) ============
+    qk2 = ttk.LabelFrame(root, text='0x606D 快捷操作 (RGB 整组顺序, 双色实测=手册naive读法)',
+                         padding=(8, 4))
+    qk2.pack(fill='x', padx=8, pady=4)
+    for i, (code, name) in enumerate((('00', 'BGR'), ('03', 'BRG'), ('04', 'GBR'),
+                                      ('05', 'GRB'), ('06', 'RBG'), ('07', 'RGB'))):
+        ttk.Button(qk2, text='%s %s' % (code, name), width=8,
+                   command=lambda c=code: inj.send('w 60 6D ' + c)
+                   ).grid(row=0, column=i, padx=3)
+    ttk.Button(qk2, text='读 0x606D', width=10,
+               command=lambda: inj.send('r 60 6D')).grid(row=0, column=6, padx=3)
+    ttk.Label(qk2, text='字母串=D[23:16]/D[15:8]/D[7:0] 的分量顺序; 切换实时生效, 不影响HDMI锁定',
+              foreground='#666666').grid(row=1, column=0, columnspan=7,
+                                         sticky='w', pady=(3, 0))
+
+    # ============ 底部: 日志 ============
+    frm = ttk.LabelFrame(root, text='串口日志', padding=(6, 4))
+    frm.pack(fill='both', expand=True, padx=8, pady=(4, 8))
+    txt_log = tk.Text(frm, height=10, font=('Consolas', 9), state='disabled',
+                      background='#101010', foreground='#C8C8C8')
+    txt_log.pack(side='left', fill='both', expand=True)
+    sb = ttk.Scrollbar(frm, orient='vertical', command=txt_log.yview)
+    txt_log.configure(yscrollcommand=sb.set)
+    sb.pack(side='right', fill='y')
+    for tag, color in (('rx', '#C8C8C8'), ('st', '#88AAFF'), ('ok', '#66CC66'),
+                       ('warn', '#E0A030')):
+        txt_log.tag_configure(tag, foreground=color)
+
+    def poll_log():
+        try:
+            while True:
+                ln, tag = log_q.get_nowait()
+                txt_log.configure(state='normal')
+                txt_log.insert('end', ln + '\n', tag)
+                if ln.startswith('='):
+                    hot = 'warn' if ('FAIL' in ln or '丢弃' in ln) else 'ok'
+                    txt_log.tag_add(hot, 'end-2l linestart', 'end-2l lineend')
+                txt_log.see('end')
+                txt_log.configure(state='disabled')
+        except queue.Empty:
+            pass
+        root.after(80, poll_log)
+
+    refresh_ports()
+    if default_port:
+        cbo_port.set(default_port)
+    root.after(80, poll_log)
+    root.protocol('WM_DELETE_WINDOW', root.destroy)
+    root.mainloop()
+
+
+if __name__ == '__main__':
+    run_gui(sys.argv[1] if len(sys.argv) > 1 else None)

I2C-Inject/logos/logo_i2c_orange.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" fill="#000000"/>
+  <rect x="38" y="64" width="436" height="186" rx="34" fill="#FF9900"/>
+  <text x="256" y="210" font-family="Arial, 'Microsoft YaHei', sans-serif" font-size="146" font-weight="900" fill="#000000" text-anchor="middle">I2C</text>
+  <text x="256" y="421" font-family="Arial, 'Microsoft YaHei', sans-serif" font-size="146" font-weight="900" fill="#FFFFFF" text-anchor="middle">Inject</text>
+</svg>

I2C-Inject/logos/make_ico_i2c.py

@@ -0,0 +1,58 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+把 logo_i2c_orange.svg 同款设计栅格化为多尺寸 .ico(供 I2C-Inject exe 图标)
+================================================================
+设计参数与 logo_ph_orange 同风格: 黑底 512, 橙色圆角矩形 x38 y64 w436 h186 rx34,
+框内 "I2C" 146px Arial Bold 黑字(居中), 下方 "Inject" 白字(基线 421)。
+"Inject" 比原版 "Tool" 长, 自动缩放到内容宽度 <= 85% 画布(436px)。
+
+输出: logos/logo_i2c_orange.png(512, 预览/复用)
+      logos/logo_i2c_orange.ico(16~256 七档, exe 图标用)
+
+用法: python make_ico_i2c.py
+"""
+
+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 标配
+MAX_W = 436                                  # 内容宽度上限(85% 画布)
+
+
+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=(255, 153, 0))
+    if not os.path.exists(FONT):
+        raise SystemExit(f'未找到字体 {FONT}, 无法栅格化')
+    px = max(8, round(146 * s))
+    f = ImageFont.truetype(FONT, px)
+    cx = size / 2
+    # I2C: 居中于橙色框(146px 下宽度远小于 436, 无需缩放)
+    d.text((cx, 64 * s + 186 * s / 2), 'I2C', font=f, fill=(0, 0, 0), anchor='mm')
+    # Inject: 基线 421 对齐(中心 ~= 368), 超宽则缩字号
+    bottom_px = px
+    while bottom_px > 8:
+        w = d.textlength('Inject', font=ImageFont.truetype(FONT, bottom_px))
+        if w <= MAX_W * s:
+            break
+        bottom_px -= 2
+    f_bottom = ImageFont.truetype(FONT, bottom_px)
+    d.text((cx, 368 * s), 'Inject', font=f_bottom, fill=(255, 255, 255), anchor='mm')
+    return img
+
+
+if __name__ == '__main__':
+    img = render(512)
+    png = os.path.join(BASE, 'logo_i2c_orange.png')
+    ico = os.path.join(BASE, 'logo_i2c_orange.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}')

I2C-Inject/rp2040_inject.py

@@ -0,0 +1,192 @@
+# LT8619C I2C 注入器 — BPI-Pico-RP2040 / MicroPython
+# ============================================================
+# 用途: 在 demo 板(LT8619C, 7bit 地址 0x32)的 I2C 总线上择机注入寄存器写入,
+#       避开 demo 板 MCU 的 ~500ms 轮询: 等一轮活动结束 + 静置 15ms 后快速
+#       "切bank→写→读回校验", 失败自动重试, 完成后立即释放总线回监听。
+# 接线: GP8(物理脚11)=SDA, GP9(物理脚12)=SCL, GND 共地; 不接 VCC, 不加上拉。
+# 串口: USB CDC, 命令均十六进制, 一行一回:
+#   w <bank> <reg> <val>   择机写 + 读回校验,  例: w 60 6E 80  (B通道镜像)
+#   r <bank> <reg>         择机读,             例: r 60 6E
+#   s                      总线边沿计数统计
+#   ?                      帮助
+# 返回行以 '=' 开头为正常结果, '!' 为告警/失败。
+
+import machine, time, sys, select, array, micropython
+
+SDA, SCL = 8, 9
+I2C_ADDR = 0x32
+FREQ = 100_000
+QUIET_MS = 50           # 静置判定窗口(总线空闲该时长后才注入)
+ARM_TIMEOUT_MS = 1500   # 武装后等下一轮总线活动的超时(超过则硬闯并告警)
+RETRY = 3
+CAP_EDGES = 8000        # 嗅探最大边沿数(内存 ~40KB)
+
+# ---- 嗅探: 紧循环读 GPIO_IN(0xD0000004) 位8/9, 变化即记录时间戳(TIMERAWL, us) ----
+# val 编码: bit0=SDA(GP8), bit1=SCL(GP9)
+# 性能: 字节码 machine.mem32 ~12us/读(混叠), viper 裸指针 ~0.27us/读(~3MHz 采样) —— 必须用 viper
+def _cap_edges_bc(ts, vv, max_n, timeout_us):
+    n = 0
+    last = (machine.mem32[0xD0000004] >> 8) & 3
+    tend = machine.mem32[0x40054028] + timeout_us
+    while n < max_n:
+        v = (machine.mem32[0xD0000004] >> 8) & 3
+        if v != last:
+            ts[n] = machine.mem32[0x40054028]
+            vv[n] = v
+            n += 1
+            last = v
+        elif machine.mem32[0x40054028] >= tend:
+            break
+    return n
+
+
+def _cap_edges_viper(ts, vv, max_n: int, timeout_us: int) -> int:
+    p_gpio = ptr32(0xD0000004)
+    p_timer = ptr32(0x40054028)
+    p_ts = ptr32(ts)
+    p_vv = ptr8(vv)
+    last = int(p_gpio[0]) >> 8 & 3
+    tend = int(p_timer[0]) + timeout_us
+    n = 0
+    while n < max_n:
+        v = int(p_gpio[0]) >> 8 & 3
+        if v != last:
+            p_ts[n] = int(p_timer[0])
+            p_vv[n] = v
+            n += 1
+            last = v
+        elif int(p_timer[0]) >= tend:
+            break
+    return n
+
+
+_cap_edges = _cap_edges_bc
+try:
+    _cap_edges_viper(array.array('i', bytes(4)), array.array('b', bytes(1)), 0, 0)
+    _cap_edges = _cap_edges_viper          # viper 可用则用(~3MHz 采样)
+except Exception:
+    pass          # 退回字节码(仅够解码 <15kHz 的总线)
+
+last_edge_us = time.ticks_us()
+edges = 0
+LED = machine.Pin(25, machine.Pin.OUT)   # 板载 LED: 常亮 = 注入器监听中
+
+
+def _on_edge(_pin):
+    global last_edge_us, edges
+    last_edge_us = time.ticks_us()
+    edges += 1
+
+
+def bus_listen():
+    """两脚浮空输入 + 双沿中断(只听不驱)"""
+    for p in (SDA, SCL):
+        pin = machine.Pin(p, machine.Pin.IN, None)
+        pin.irq(trigger=machine.Pin.IRQ_RISING | machine.Pin.IRQ_FALLING,
+                handler=_on_edge)
+
+
+def wait_window():
+    """等一轮总线活动结束再静置 QUIET_MS; 返回 True=正常等到, False=超时硬闯"""
+    saw = edges
+    t0 = time.ticks_ms()
+    while edges == saw:                       # 等下一轮活动出现(demo ~500ms 一轮)
+        if time.ticks_diff(time.ticks_ms(), t0) > ARM_TIMEOUT_MS:
+            print('! 无总线活动 %.0fms, 直接注入' % ARM_TIMEOUT_MS)
+            return False
+        time.sleep_ms(2)
+    t0 = time.ticks_ms()
+    while True:                               # 等静置
+        if time.ticks_diff(time.ticks_us(), last_edge_us) >= QUIET_MS * 1000:
+            return True
+        if time.ticks_diff(time.ticks_ms(), t0) > 2000:
+            print('! 静置超时, 直接注入')
+            return False
+        time.sleep_us(200)
+
+
+def inject(bank, reg, val=None):
+    """注入并校验; val=None 只读。返回 (ok, readback)"""
+    for attempt in range(1, RETRY + 1):
+        wait_window()
+        i2c = machine.I2C(0, sda=machine.Pin(SDA), scl=machine.Pin(SCL), freq=FREQ)
+        try:
+            if val is not None:
+                i2c.writeto(I2C_ADDR, bytes([0xFF, bank]))     # 切 bank
+                i2c.writeto(I2C_ADDR, bytes([reg, val]))       # 写寄存器
+            rb = i2c.readfrom_mem(I2C_ADDR, reg, 1)[0]         # repeated-start 读回
+        except OSError as e:
+            print('! 第%d次总线错误 %s' % (attempt, e))
+            rb = None
+        finally:
+            bus_listen()                                       # 立即释放总线
+        if rb is None:
+            continue
+        if val is None or rb == val:
+            return True, rb
+        print('! 第%d次校验不符: 写%02X 读%02X' % (attempt, val, rb))
+    return False, None
+
+
+def main():
+    bus_listen()
+    for _ in range(3):                    # 上电自检: 快闪 3 次
+        LED.on(); time.sleep_ms(80); LED.off(); time.sleep_ms(80)
+    LED.on()                              # 常亮 = 监听中
+    print('LT8619C 注入器就绪 GP8=SDA GP9=SCL %dkHz addr 0x%02X' % (FREQ // 1000, I2C_ADDR))
+    poll = select.poll()
+    poll.register(sys.stdin, select.POLLIN)
+    buf = b''
+    while True:
+        try:
+            if poll.poll(50):
+                buf += sys.stdin.read(1)
+                if buf[-1:] not in (b'\n', b'\r'):
+                    continue
+                line = buf.strip().decode()
+                buf = b''
+                parts = line.split()
+                if not parts:
+                    continue
+                cmd = parts[0].lower()
+                if cmd == 'w' and len(parts) == 4:
+                    bank, reg, val = (int(x, 16) for x in parts[1:])
+                    ok, rb = inject(bank, reg, val)
+                    print('= w %02X %02X %02X : %s 读回=%s' %
+                          (bank, reg, val, 'OK' if ok else 'FAIL',
+                           '%02X' % rb if rb is not None else '--'))
+                elif cmd == 'r' and len(parts) == 3:
+                    bank, reg = (int(x, 16) for x in parts[1:])
+                    ok, rb = inject(bank, reg)
+                    print('= r %02X %02X : %s %s' %
+                          (bank, reg, 'OK' if ok else 'FAIL',
+                           '%02X' % rb if rb is not None else '--'))
+                elif cmd == 's':
+                    print('= 边沿计数 %d' % edges)
+                elif cmd == 'c':
+                    ms = int(parts[1]) if len(parts) > 1 else 700
+                    for p in (SDA, SCL):      # 捕获期间暂停监听中断
+                        machine.Pin(p, machine.Pin.IN, None).irq(handler=None)
+                    ts = array.array('i', bytes(4 * CAP_EDGES))
+                    vv = array.array('b', bytes(CAP_EDGES))
+                    n = _cap_edges(ts, vv, CAP_EDGES, ms * 1000)
+                    bus_listen()
+                    print('= capture %d edges / %d ms' % (n, ms))
+                    t0 = ts[0] if n else 0
+                    out = []
+                    for i in range(n):
+                        out.append('%d %d' % (ts[i] - t0, vv[i]))
+                        if len(out) >= 100:
+                            print('C ' + '\nC '.join(out))
+                            out = []
+                    if out:
+                        print('C ' + '\nC '.join(out))
+                    print('C.')
+                else:
+                    print('? w bank reg val | r bank reg | s | c [ms]')
+        except KeyboardInterrupt:
+            break
+    print('退出')
+
+
+main()

README.md

@@ -1,3 +1,35 @@
 # LT8619C_Debug_Tools
 
-本仓库用存储LT8619C调试过程中需要的一些小工具（包括AI生成）
+LT8619C（HDMI→RGB888）→ DLPC3421 投影转接板调试配套上位机工具集。
+上游主仓库（固件）：[LT8619C_DLPC3421_HDMI](https://gitea.hulk.wang/hulk/LT8619C_DLPC3421_HDMI)。
+
+## 工具一览
+
+| 工具 | 用途 | 快速开始 |
+|---|---|---|
+| [HDMI-Tool](HDMI-Tool/) | HDMI 源端：EDID 查看/解算、分辨率切换、纯色与测试图案全屏投屏（R/G/B 纯色值按钮用于位交换类测试） | 双击 `HDMI-Tool.exe`；详见 [HDMI-Tool/README.md](HDMI-Tool/README.md) |
+| [I2C-Inject](I2C-Inject/) | LT8619C 寄存器在线读写：RP2040 注入器在 demo 板 I2C 总线上择机注入（避让主控轮询，写后自动读回校验） | 需配合 RP2040 固件 `rp2040_inject.py`；详见 [I2C-Inject/README.md](I2C-Inject/README.md) |
+
+## 环境要求
+
+- 打包版 exe 开箱即用（Windows 10/11 x64，无需安装 Python）
+- 源码运行：Python ≥3.10；HDMI-Tool 为纯标准库（自定义图片 JPG/BMP 需 Pillow）；
+  I2C-Inject 需 `py -m pip install pyserial`
+- 重新打包：各工具目录内 `python build_exe.py`（自动安装 PyInstaller）
+
+## 目录结构
+
+```
+LT8619C_Debug_Tools/
+├── HDMI-Tool/            # 源码 + 打包 exe + 测试图资产 + 图标 + README
+├── I2C-Inject/           # PC 端 GUI + RP2040 固件 + 打包 exe + 图标 + README
+├── LICENSE
+└── README.md
+```
+
+## 备注
+
+- 源码与打包产物均入库：exe 改动跟随源码提交更新
+- 两件工具的寄存器语义（0x606E 位交换 / 0x606D 整组顺序）均经 demo 板逻辑分析仪
+  双色交叉实测，过程数据与规程存于上游主仓库 `doc/architecture/`
+- 更新：2026-09-03