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

2026-09-08 22:56:52 +08:00
commit 8d368de3b5
491 changed files with 67678 additions and 0 deletions
@@ -0,0 +1,2 @@
+屏幕型号：RGB-Matrix-P3-64x64-F
+参考网站：https://docs.waveshare.net/RGB-Matrix-Px-64x64?variant=P3-64x64-F&spec=P3-64x64-F
@@ -0,0 +1,88 @@
+# 核桃派 ZeroW + 64×64 HUB75 屏接线与首次上电检查
+
+适用范围：一块核桃派 ZeroW、一块 `RGB-Matrix-P3-64x64-F`（64×64、1/32 扫描、ABCDE）、一套独立 5V 屏幕电源。本阶段**不连接 Unit ADC**。
+
+## 先看安全边界
+
+> **接线前必须让核桃派和屏幕全部断电。** 拔掉核桃派 USB-C 供电，关闭或拔掉屏幕 5V 电源。不得带电插拔 HUB75、不得把屏幕 5V 接到核桃派 40-pin 的 5V 脚、不得把 5V 接到任何 PI 信号脚。
+
+- 核桃派继续用自己的 USB-C 供电。
+- 屏幕用独立、极性正确的 5V 电源直接接屏幕电源端；参考额定能力 5V/4A。
+- 两者只通过 HUB75 GND 和电源负极形成共地；屏幕的大电流不得流经核桃派排针。
+- 只接屏幕标有 `INPUT` / `IN` 的 HUB75 口；`OUTPUT` / `OUT` 本项目不用。
+- 物理脚 3、5 留给后续 ADC，物理脚 32（PI16）保留，本阶段都不接。
+
+## HUB75 INPUT 的编号
+
+以下编号采用本项目已经核验的 Waveshare HUB75 INPUT 定义，不根据线材颜色猜测：
+
+```text
+HUB75 INPUT（按信号定义核对）
+
+pin 16 R1    pin 15 G1    pin 14 B1    pin 13 GND
+pin 12 R2    pin 11 G2    pin 10 B2    pin  9 E
+pin  8 A     pin  7 B     pin  6 C     pin  5 D
+pin  4 CLK   pin  3 LAT   pin  2 OE    pin  1 GND
+```
+
+若插座缺口、丝印或观看方向与上面排布不一致，以屏幕 PCB 的 `R1/G1/.../GND` 信号丝印和 `INPUT` 标记为准，不要强插排线。
+
+## 逐根信号接线表
+
+| HUB75 pin | 信号 | 核桃派物理脚 | H618 管脚 | 检查用途 |
+|---:|---|---:|---|---|
+| 16 | `R1` | 29 | `PI0` | 上半屏红 |
+| 15 | `G1` | 31 | `PI1` | 上半屏绿 |
+| 14 | `B1` | 33 | `PI2` | 上半屏蓝 |
+| 13 | `GND` | 34 | `GND` | 第二根信号地 |
+| 12 | `R2` | 35 | `PI3` | 下半屏红 |
+| 11 | `G2` | 37 | `PI4` | 下半屏绿 |
+| 10 | `B2` | 8 | `PI5` | 下半屏蓝 |
+| 9 | `E` | 16 | `PI12` | 行地址 bit 4，不能省 |
+| 8 | `A` | 10 | `PI6` | 行地址 bit 0 |
+| 7 | `B` | 28 | `PI9` | 行地址 bit 1 |
+| 6 | `C` | 27 | `PI10` | 行地址 bit 2 |
+| 5 | `D` | 15 | `PI11` | 行地址 bit 3 |
+| 4 | `CLK` | 38 | `PI13` | 移位时钟 |
+| 3 | `LAT` | 36 | `PI15/GPIO` | GPIO 锁存 |
+| 2 | `OE` | 40 | `PI14/PWM4` | 硬件定时输出使能，低有效 |
+| 1 | `GND` | 30 | `GND` | 第一根信号地 |
+
+## 屏幕独立供电
+
+1. 屏幕电源正极只接屏幕电源端 `5V` / `VCC`。
+2. 屏幕电源负极只接屏幕电源端 `GND`。
+3. 核桃派物理脚 30、34 分别接 HUB75 INPUT pin 1、13 的 GND，形成信号共地。
+4. 不把屏幕 5V 接到核桃派物理脚 2 或 4；不从核桃派给屏幕供电。
+5. 电源关闭时用目视或万用表通断档确认没有把屏幕 5V 和 GND 反接。
+
+## 断电完成后的逐项检查
+
+- [ ] 核桃派 USB-C 已拔，屏幕 5V 电源已关闭或拔掉。
+- [ ] 使用的是屏幕 `INPUT`，不是 `OUTPUT`。
+- [ ] 16 根 HUB75 连接逐行与表格一致，没有按线色猜信号。
+- [ ] `A/B/C/D/E` 五根都已接，尤其 `E → 物理脚 16`。
+- [ ] `CLK/LAT/OE → 物理脚 38/36/40`；特别确认 LAT/OE 不是旧版的相反接法。
+- [ ] 两组 RGB 没有上下半屏或红绿蓝互换。
+- [ ] HUB75 pin 1、13 分别到核桃派 GND 物理脚 30、34。
+- [ ] 屏幕独立 5V 极性正确，且没有接到核桃派 5V 排针。
+- [ ] 物理脚 3、5、32 都保持空置；Unit ADC 完全未接。
+- [ ] 裸露导体没有互碰，线材不会被风扇、屏幕背板或金属外壳夹住。
+
+## 首次上电顺序（必须等 Codex 指令）
+
+本表只配套硬件映射 `walnutpi-pi-bank-pwm-oe-v2`。接线完成后先不要自行长时间点亮。回复“屏幕接线完成，LAT 已接物理脚 36，OE 已接物理脚 40，已按要求检查，可上电测试”。随后按指令：先启动低亮度全黑安全画面，再依次测试全红、全绿、全蓝、全白、四角、关键行、方向、文字、图片和动画。任何一步异常都停在该步，只检查对应线组。
+
+## 快速故障对应关系
+
+| 现象 | 只优先检查 |
+|---|---|
+| 上半屏缺某颜色 | `R1/G1/B1` 对应单线 |
+| 下半屏缺某颜色 | `R2/G2/B2` 对应单线 |
+| 红绿蓝互换 | 六根 RGB 的信号名，不查行地址 |
+| 半屏、重复行、行位置错误 | `A/B/C/D/E`，特别是 `E` |
+| 画面横向错位或随机数据 | `CLK` 与六根 RGB |
+| 整屏不亮或闪一下 | `OE`、`LAT`、共地和屏幕 5V 极性 |
+| 随机亮点或抖动 | 共地、线长、接触和 5V 稳定性 |
+
+失败时整机断电后再动线；不得带电逐根试插。