初始化奇妙小屏幕控制器项目

2026-09-08 22:56:52 +08:00
commit 8d368de3b5
491 changed files with 67678 additions and 0 deletions
@@ -0,0 +1,66 @@
+# 核桃派 ZeroW + Unit ADC v1.1 接线与首次上电检查
+
+适用实物：核桃派 ZeroW、已经接好并通过基础画面测试的 HUB75 屏、`M5Stack Unit ADC v1.1 / U013-V11 / ADS1110`。本模块只并联测量屏幕输入端 5V，不测电流。
+
+## 接线前必须断电
+
+> 拔掉核桃派 USB-C，并关闭或拔掉屏幕独立 5V 电源。屏幕、核桃派和 Unit ADC 全部无电后才能插拔或移动任何线。
+
+- 不拆改已经验证通过的 HUB75 信号线。
+- 不把屏幕 5V 接到核桃派物理脚 2 或 4，不通过核桃派排针给屏幕供电。
+- 不让屏幕的大电流经过 Unit ADC、Grove 线或 VIN 测量线。
+- 不使用物理脚 32；它仍然保留。
+- ADC 输入不得超过模块官方 `0..12V` 范围，当前只测约 5V。
+
+## 六个连接点
+
+Unit ADC 有两组不同职责的连接：Grove 四线负责模块供电与 I²C；VIN 两线只负责并联测量。两组线都接到同一套屏幕输入 5V/GND，但不能省略或混淆。
+
+| 模块端 | 常见线色 | 连接位置 | 用途 |
+|---|---|---|---|
+| Grove `SDA` | 黄 | 核桃派物理脚 `3` / `PI8` / `SDA1` | I²C 数据 |
+| Grove `SCL` | 白 | 核桃派物理脚 `5` / `PI7` / `SCL1` | I²C 时钟 |
+| Grove `5V` | 红 | 屏幕输入端所用的同一稳定系统 `5V` | 只给 Unit ADC 供电 |
+| Grove `GND` | 黑 | 屏幕输入端所用的同一系统 `GND` | 模块供电地与 I²C 共地 |
+| 测量 `VIN+` | 按端子丝印 | 并联到屏幕电源输入端的 `5V` 测试点 | 被测正端 |
+| 测量 `VIN-/GND` | 按端子丝印 | 并联到同一屏幕电源输入端的 `GND` | 被测负端 |
+
+不要只根据跳线颜色猜测 VIN 正负；VIN 端必须以模块外壳、PCB 或端子丝印为准。Grove 线色若与表格不同，也必须以模块和线束标注的 `SDA/SCL/5V/GND` 为准。
+
+## 并联关系
+
+```text
+屏幕电源 5V ────────┬────────> 屏幕 5V 输入（原大电流路径不变）
+                     ├────────> Unit ADC Grove 红线 5V
+                     └────────> Unit ADC VIN+
+
+屏幕电源 GND ───────┬────────> 屏幕 GND 输入（原大电流路径不变）
+                     ├────────> Unit ADC Grove 黑线 GND
+                     └────────> Unit ADC VIN-/GND
+
+核桃派物理脚 3 ──────────────> Unit ADC 黄线 SDA
+核桃派物理脚 5 ──────────────> Unit ADC 白线 SCL
+```
+
+## 断电状态下逐项检查
+
+- [ ] 模块丝印确认为 `U013-V11`，芯片方案为 `ADS1110`。
+- [ ] 核桃派 USB-C 已拔，屏幕独立 5V 已关闭或拔掉。
+- [ ] 黄线 `SDA → 物理脚 3`，白线 `SCL → 物理脚 5`，没有对调。
+- [ ] 红线只接系统 5V，黑线只接系统 GND，没有反接。
+- [ ] `VIN+` 接屏幕输入端 5V，`VIN-/GND` 接同一点的 GND。
+- [ ] 屏幕原有粗电源线保持直接供电，任何负载电流都不经过 ADC。
+- [ ] HUB75 信号接线保持原样，物理脚 32 仍空置。
+- [ ] 所有裸露导体固定，无短路、松脱或碰到金属背板的风险。
+
+完成以上检查后仍然保持断电，并回复：`ADC 接线完成，可上电检查`。得到下一步指令前不要自行上电。
+
+## 上电后由 Codex 逐项检查
+
+1. 先确认核桃派和服务恢复在线，不立即校准。
+2. 确认 `/dev/i2c-1` 仍存在，地址 `0x48` 有响应。
+3. 检查配置低 7 位为 `0x0C`，取得 5 个新样本中位数。
+4. 确认未校准电压合理且稳定，网页故障状态自动恢复。
+5. 再单独暂停，请用户把万用表并联到同一个屏幕输入 5V/GND 点并只提供一个稳定读数。
+
+任一步出现无响应、持续负 raw、短读、配置不符、异常发热或显示故障，都先断电并只检查对应线组，不跨过失败项。