墨嵌第一版：裸屏完全不闪的排查记录

2026-10-24更正：用户确认同一块旧屏接官方驱动板能够正常显示，两版PCB均为全覆盖铺铜。两版GPIO和主要供电路径相同，第二版通过排母接官方驱动板。此前“第一版缺地覆铜、第二版新增地覆铜”的判断撤回；解析记录差异不足以证明实际缺铜。故障重点仍是第一版自制裸屏驱动链路，尚未定位到原理图、PCB布线、装配或运行时信号中的具体原因。请结合两版对比与故障范围更新阅读。

核对日期：2026-10-23。用户确认：24 针裸屏直接插自制 PCB；ESP32 能烧录并持续输出串口，屏幕完全不闪。

结论：发现了具体硬件设计问题和软件问题，但没有硬件测量，尚不能确定过去不显示的唯一根因。当前 PCB 与最新完整固件的六根屏幕信号对应一致，不能据此改动 GPIO。

本次早期曾将模组焊盘编号与 GPIO 的对应关系读错一位，随后已按原厂手册、库符号和 PCB PAD_NET 三方复核并纠正；“CS17/DC16/RST15/BUSY6”的早期推断作废。

已检查的真实资料

• 板级源文件：ProPrj_墨嵌第一版_2026-10-23.epro2 本地资料 / 待补充。压缩包 CRC 检查通过；已解析 363 个文档区段及 23868 行原始记录，并处理同 ID 更新与删除。
• 最完整的固件：weixue 本地资料 / 待补充。真实配置目标为 ESP32-S3，Flash 16MB，Octal PSRAM；显示组件为 SSD1683，使用自己的 Paint/epd_flush。
• 本地原始屏资料：4.2-inch-e-Paper-V2(1).pdf 本地资料 / 待补充.pdf)、SSD1683.pdf 本地资料 / 待补充。这些资料说明项目预期使用的面板，不能替代实物排线型号确认。
• 历史工程备份位于 [本地工程路径]。检索范围内未找到对应 Gerber/钻孔文件。
• 解包原始数据：source.epru.txt 本地资料 / 待补充；可复核结果：audit_summary.json 本地资料 / 待补充。

实际引脚：已核对，一致

U5 是 ESP32-S3-WROOM-1(N16R8)。下表按模组的物理焊盘号核对，不能把焊盘号直接当 GPIO 号。

FPC1.15/16 接 3V3，FPC1.17 接 GND，FPC1.8 接 GND 选择四线 SPI。原厂依据：Espressif 模组手册，引脚定义、微雪 V2 手册，第5/6/32印刷页。

硬件发现

1. 覆铜判断更正：撤回“第一版缺地覆铜”结论

已确认情况： 用户明确说明第一版与第二版均为全覆盖铺铜，且记得导通检查正常。后续按这一实际设计背景排查。

此前判断的问题： 解析器在两份归档中读到的POUR/POURED记录不同，首轮报告把这种差异过度解释为实际PCB缺少地覆铜。未查明归档记录与编辑器/制造输出的对应关系，不能据此判断实物缺铜。

当前处理： 撤回该故障判断，不要求据此重新铺铜或改地网。保留原始解析记录作为文件观察，不作为实际缺地证据。屏不显示的具体原因仍需屏端供电、复位/SPI和升压工作证据。

2. USB-C 两根 CC 共用一颗下拉电阻：确定接法问题

问题： USB2 的 A5/CC1 与 B5/CC2 同接 $1N410839，只经 R21=5.1kΩ 下拉。

为什么与风险： Type-C 受电端需要两个独立的 CC 下拉；共用可能使部分 C-C 电缆/电源无法正确识别。用户已能运行主控时，不能拿它单独解释屏不闪。

怎么改、修改后连接、建议参数： 断开 CC1 与 CC2 的互连；CC1 → 5.1kΩ → GND，CC2 → 另一颗5.1kΩ → GND，可用1%电阻。Renesas 官方说明。

3. U6 输入本地去耦偏小：确定偏离推荐，故障影响待测

问题： U6 是 ME6217C33M5G；BAT_ON 输入本地 C23=1µF，输出 C24=1µF、C25=10µF。

为什么与风险： 原厂建议输入和输出电容各至少4.7µF；输入阻抗较高且电容较小时可能振荡。ESP32 能输出日志不能证明屏幕刷新期间供电无跌落。ME6217 原厂手册，第6页。

怎么改、修改后连接、建议参数： C23 改用适当耐压的4.7–10µF陶瓷电容，考虑直流偏压后的有效容量，贴近 U6.1(VIN)/U6.2(GND)。用示波器检查 U6.5、U5.2、FPC1.15/16 在刷新和联网时的电压。U6 标称800mA，实际能力受输入压差和散热影响，不能简单认定为“LDO电流不够”。

4. 升压基本拓扑对得上，焊接与实装值尚未验证

Q3=BSS138LT1G，L1=10µH，D2/D3/D5=MBR0530，R8=3Ω，R7=10kΩ；C7/C10 标注4.7µF。Q3.1=GDR，Q3.2=RESE，Q3.3接L1及二极管开关节点，R8连接RESE与地。与微雪 V2 官方参考拓扑基本一致。

24针连接器相同，只能确认机械接口的一部分；实际排线方向、接触、面板型号、装配极性及电压仍须验证。不能把“拓扑一致”说成升压电路已经工作。

另有条件性问题：U4 CH340C 的 RTS#直连EN、DTR#直连GPIO0。部分串口软件会拉低EN；用户目前能持续运行，这一项排查优先级较低。Espressif 官方说明。

软件发现

1. BUSY 超时被吞掉。 ssd1683.c:70 本地资料 / 待补充 等待5秒后只 break，初始化仍可能在368行打印完成并返回 ESP_OK。因此日志中的“初始化成功”不证明屏响应；建议超时返回错误，并让调用者停止后续刷新。
2. 混入旧版命令概念。 ssd1683.h:16 本地资料 / 待补充 定义 PSR=0x00，在 ssd1683.c:346 本地资料 / 待补充 实际发送。两份 SSD1683/V2 命令表没有这一命令；微雪旧版驱动才用它。属于确定的协议偏差，但不能单凭未记录命令断言它一定导致完全不闪。
3. 波形选择说明与实际刷新不符。 本地233字节 LUT 与微雪官方 V2 四灰阶 LUT 完全一致；官方普通黑白初始化不加载该套波形，四灰阶使用 0x22=0xCF。项目把它用于普通黑白路径，随后又用 0xF7，该值会包含重新加载 OTP LUT 的操作；“外部LUT”注释不足以说明实际使用的波形。
4. 休眠前寄存器用错。 头文件把 0x21/0x22 的 Control 1/2 命名对调；ssd1683.c:648 本地资料 / 待补充 向实际 0x21 写单字节 08，没有正确配置所声称的关闭序列。这不能解释首次启动完全不闪，但应修正。
5. 初始化 VCOM 配置没有落实。 main 中的配置/NVS值没有用于初始化电压，外部 LUT 路径实际写的是 LUT 尾部的0x30。不能把注释中的“原先工作值”当作实际测量值。

比较基线：微雪官方 V2 驱动。建议先用其普通黑白 Init → 写RAM → 全刷 流程验证，保留当前正确引脚，再逐项加入局刷、自定义波形与应用功能。

现板的最短测量路径

以下以真实面板确认为该 V2/SSD1683 为前提，所有电压相对可靠公共地测量。不能只在待机或休眠后测高压便判定升压坏了。

若电源/地正常而屏端无正确SPI或RST，查固件及信号连接；若命令正确且GDR有开关但升压无输出，重点查Q3、L1、二极管方向、R8实装值、焊接和回流；若屏端没有GDR驱动，还需区分屏型号/初始化不符、屏没收到命令、供电/复位或面板故障。当前不能直接判定换Q3或换屏。

本次验证边界

已完成：源包CRC、解包一致性、原理图/PCB网络与原厂引脚交叉核对、源码与官方协议比较。未修改原始EDA工程或固件；未运行本次固件编译、烧录、串口采集或硬件测量。历史编译/烧录日志只说明过去某次操作，不作为本次验证结果。报告和分析脚本保存在本次现有工作区。