一块黑屏的 TFT:从 RTT 日志到 QSPI 虚焊
VESPA UI EB3 build FCT 不良复盘
EB3 build FCT 不良复盘 · NG_1
64200103255814624264300150
平台:VESPA UI(PSoC6 CY8C6144 + LVGL 8.4 + 外挂 XM25QH64D 8MB QSPI Flash,LVGL/页面代码跑在 XIP)
0. 引子:最花时间的,是”曾经好过”的不良
EB3 build 的 FCT 报表里,这台模组的表现很典型:
- 上电黑屏,夹具发
(TEST)串口没有任何应答; - 但它在 FCT1、FCT2 都是 PASS,FCT2 还读到了 TFT / Touch 的版本号;
- 工站报的 Failed Msg 是
1.1.2 All LED ON Check_Block_1_2(3)—— 可实际上连屏都没亮,根本轮不到 LED 检查。
“曾经好过、现在不亮、时好时坏”——整个过程我觉得挺值得写一篇笔记进行记录,并且有四点主要的复盘点:
- 先写交叉验证矩阵再动手;
- 硬件先行,先测供电和基本功能;
- 用 J-Link 读 RTT 日志 + AI 辅助,把”日志断在哪”翻译成”代码走到哪”;
- 不急着补焊,保留现场,多次读数找规律,最后从数据里算出坏的是哪一根引脚。
1. 先认识这个模组:硬件与软件背景
1.1 模组由什么组成
VESPA UI 模组 = TFT PCBA(D)+ Touch PCBA(C)+ LCD 屏 + 旋钮/按键/LED 显示,装在咖啡机面板上。
| 板 | 关键器件 | 作用 |
|---|---|---|
| TFT PCBA(D) | CY8C6144LQI-S4F82(PSoC6,QFN-68) | 主控:跑 LVGL UI、TFT 驱动、USCP/BRSCOM/MCP 协议 |
| XM25QH64D(64Mb QSPI NOR,SOIC-8) | 存 UI 代码 + 图片/字模(XIP 执行)+ OTA 镜像 | |
| LCD 12pin FPC 连接器(J3) | TFT-RST / SDA / SCL / CS / RS + TE + 背光 | |
| 24MHz 晶振、旋钮编码器(EN1/EN2/SW1)、SWD 调试口(J5) | 时基、旋钮输入、调试 | |
| 背光驱动(MOSFET + 限流电阻,PWM 调光) | 屏背光 | |
| Touch PCBA(C) | CY8C4025LQI-S411(PSoC4,QFN-24) | 触摸/按键采集、LED 显示、与 TFT 通信 |
| Aip33A07(LED 显示驱动)、RGB LED、4 个按键 | 面板 LED 显示与按键 | |
| JW5101(24V→5V)、AiP6026E(5V→3.3V) | 电源树 | |
| J1(接主板)、J2(12pin,接 TFT) | 对外/对内连接器 |
1.2 通信拓扑
flowchart TB
subgraph MAIN["咖啡机主板"]
direction LR
M_PWR["24V_IN / 5V / 3V3"]
M_BRS["BRSCOM"]
M_AUX["AUX(夹具 / 上位机)"]
end
subgraph TOUCH["Touch PCBA (C)"]
direction LR
T_MCU["CY8C4025LQI-S411<br/>PSoC4"]
T_IO["LED 显示 / 按键 / RGB"]
end
subgraph TFT["TFT PCBA (D)"]
F_MCU["CY8C6144LQI-S4F82<br/>PSoC6<br/>SCB0 SPI · SCB1 MCP · SCB2 BRSCOM · SCB4 AUX"]
F_FLASH["XM25QH64D 8MB QSPI NOR<br/>UI 代码/图片 · XIP @0x18000000"]
F_LCD["LCD 12pin FPC<br/>RST / SDA / SCL / CS / RS + TE + 背光"]
F_ENC["旋钮编码器<br/>EN1 / EN2 / SW1"]
F_SWD["SWD 调试口 J5"]
end
M_PWR -->|"J1:24V_IN / 5V / 3V3"| T_MCU
M_BRS -->|"J1:BRSCOM"| T_MCU
T_MCU -->|"J2 (12pin)<br/>MCP UART + BRSCOM / AUX 透传 + 电源"| F_MCU
M_AUX -.->|"AUX(经 Touch 透传,USCP)"| F_MCU
F_MCU -->|"QSPI(SMIF 1-4-4)"| F_FLASH
F_MCU -->|"SPI"| F_LCD
F_MCU --- F_ENC
F_MCU --- F_SWD
classDef culprit fill:#ffe3e3,stroke:#c0392b,stroke-width:2px,color:#7b241c;
class F_FLASH culprit;
| 链路 | 物理连接 | 协议 | 用途 |
|---|---|---|---|
| 夹具/上位机 ↔ TFT | AUX UART:J1 → Touch 板(门控/透传)→ J2 → TFT(SCB4) | USCP(ASCII 命令,如 (TEST)) |
FCT 测试、版本读取、产线 OTA |
| 主板 ↔ TFT | BRSCOM UART(SCB2) | BRSCOM 帧协议 | 咖啡机主控与 UI 的命令/状态 |
| Touch ↔ TFT | MCP UART(SCB1) | rts_mcp 帧 | 触摸/按键事件、启动握手、OTA 协同 |
| TFT ↔ LCD | SPI(SCB0) | NV3002B 命令 | 显示 |
| TFT ↔ Flash | QSPI(SMIF,1-4-4) | — | UI 代码/图片 XIP + 镜像存储 |
1.3 软件与存储架构
两个工程:
- VespaTFTBoot(Bootloader,内部 Flash 前 32KB):
上电先看复位原因;POR/XRES 时若检测到 AUX_RX 被拉高(Serkit/夹具在位)就进入 OTA,通过 AUX UART 收 S19,先整片擦除外部 QSPI,再分别写内部 Flash 和外部 Flash;否则软复位跳到 App。 - VespaTFTApp(应用,本 build 是 FCT 固件):
单核 CM4、无 RTOS,用协作式调度器(RTS,protothread)在主循环里轮询 9 个线程;UI 用 LVGL 8.4;FCT 固件只跑 FCT 页面 + USCP 测试协议 + BRSCOM 桩。
存储布局:
| 区域 | 大小 | 内容 |
|---|---|---|
| 内部 Flash | 256KB | Bootloader 32KB + App;末尾 16KB 是 NVM(4 bank × 4KB,带 CRC32) |
| 外部 QSPI | 8MB | LVGL 代码(lv_*.o)、页面代码(ui_page*.o、screens.o)、大图片/字模(.cy_xip_code) |
这是理解本次不良的关键:屏幕 UI 的代码和图片全部在外部 Flash 上,CPU 是直接从外部 Flash 取指执行(XIP) 的。所以外部 Flash 一旦读不到,MCU 内部 Flash 的启动代码还能跑(能打日志)
开机后第一次执行外部 Flash 里的代码,是 app_main() 里的 detect_fct_mode()(读 J4 PIN8 的短接状态,决定进 FCT 页面还是等待页)。本次不良的日志正好断在它前面。
2. 硬件先行
模组是成品级的,能换的组件不止一个。先查三件事:
| 检查项 | 结果 | 结论 |
|---|---|---|
| 5V / 3V3 供电 | 正常 | 电源不是问题 |
| J-Link 能否连上 MCU(单板测试点) | 能连上 | MCU 大概率没死 |
串口 (TEST) 应答 |
无应答 | 软件没跑到通信,串口没初始化,怀疑外设初始化之前就阻塞 |
接下来的交叉验证,先写表格,再动手:2³ 交叉验证矩阵:
模组级反推和单板分析不一样:可更换件有 3 个(TFT 控制板 / LCD 屏 / Touch 板),理论上有 2³ = 8 种 GOOD/NG 组合。与其边换边想,不如先把表画出来、按序号编好、每做一组就填一行:
锁定在 TFT 组件上,Touch 板排除。先把组合表列出来,否则换着换着就乱了。
4. 让日志说话:好板和坏板差在哪
MCU 没死、供电正常,那就看它到底跑到哪一步。接上 J-Link,打开 RTT Viewer:
好板(良品):
1 | |
坏板(NG):
1 | |
坏板在 nvm: boot bank 3 之后就没了。MCU 起来了、内部 Flash 的代码在跑、NVM 也读完了,然后就卡住了。
5. 把代码和日志丢给 AI:从”日志断在哪”到”代码走到哪”
这是这次排查的转折点。
硬件工程师对代码执行顺序不一定熟,但日志断点 + 源码是 AI 最擅长的翻译工作。我把三样东西给了 AI:
- 好板 / 坏板的 RTT 日志;
- 代码仓库路径(VespaUITFT,含 Bootloader 和 App 两个工程);
- 现象描述(黑屏、串口无应答、FCT1/FCT2 曾 PASS)。
AI 给出的分析非常关键:
- 按
app_main()的执行顺序,nvm: boot bank 3对应nvm_boot_init()的最后一行; - 从这一行到下一条日志
page init...之间,会执行的函数调用链有:uart_uscp_init()→USCP_handler_init()→detect_fct_mode()→__enable_irq()→ 第一轮主循环 →thread_lvgl→ui_user_init()→driver_tft_init(); - 其中前两个是纯外设配置、没有等待;**
detect_fct_mode()是第一次执行”外部 Flash 里的代码“**(ui_page_fct.o被链接到 XIP 区0x18000000); - 所以最可疑的假设是:外部 QSPI 读不到,CPU 取指到
0xFFFFFFFF,触发 HardFault。
这一步为什么重要:它把”日志停在这里”这种模糊现象,变成了一个可以用 J-Link 一条命令验证的假设。
AI 不替你做判断,但它能把”硬件工程师不熟的代码执行链”翻译成”可验证的下一步”。
6. J-Link Commander:一条命令验证假设
用 J-Link Commander 读关键地址(不是 RTT Viewer,它没有命令控制台):
1 | |
翻译一下:
0x10008000是 App 向量表(初始 SP + Reset_Handler),内部 Flash 是好的;0x18000000全 FF → 外部 QSPI 读不到;CFSR=0x00010000→ CPU 执行了未定义指令,也就是0xFFFFFFFF;RES_CAUSE=0x11→ 板子在 WDT 复位和软复位之间循环(fault → 4.1 s 被狗复位 → 再来一遍)。
假设完全成立:App 从内部 Flash 启动 → 第一次调用外部 Flash 里的函数 → 取指 0xFFFFFFFF → HardFault → 看门狗复位 → 死循环 → 永远黑屏。
7. 别急着补焊:先保留现场,做”按压实验”
补焊会把现场破坏掉,而且如果根因不是焊接,补完还是不良,反而更难查。
先做两个实验:
- 按压实验:用手稍用力按住 Flash 芯片,重新上电 → **正常显示
FCT MODE**; - 重复读数:按住时读两次、不按住时读两次,看数据是否可重复。
结果:
| 状态 | 0x18000000(4 字) |
0x1802277C(4 字) |
|---|---|---|
| 按住(第 1 次) | CFCCFF00 DB6CC03C 9BED6FFB 1EFC3100 |
180226C1 18022605 18022621 00004770 |
| 不按住(第 1 次) | CFCCFF00 DF6CC47C DFED6FFF 5EFC7544 |
5C4666C5 FCC67704 644F4744 F4444C7C |
| 按住(第 2 次) | CFCCFF00 DB6CC03C 9BED6FFB 1EFC3100 |
180226C1 18022605 18022621 00004770 |
| 不按住(第 2 次) | CFCCFF00 DF6CC47C DFED6FFF 5EFC7544 |
FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF |
两次”按住”读数完全一致,两次”不按住”也高度一致 → 机械按压可稳定复现,是接触/焊接问题,不是 Flash 内容问题。
而且”按住”时 0x1802277C 读出的 180226C1 / 18022605 / 18022621 是三个奇数地址(Thumb 函数指针),00004770 是 bx lr —— 正是页面结构体 rts_gui_page_t page = {.init, .loop, .uninit},和好板日志里的 page init...(0x1802277c) 完全对得上。Flash 里的内容本来就是好的。
8. 扩展:从数据里找规律,坏的是哪一根线?
不按住时不是每次都全 FF,而是部分位翻转。把”按住”和”不按住”的 0x18000000 做异或:
1 | |
每个字节里只有 bit2 和 bit6 在翻转。
QSPI 是 4 线并行,一个字节两个时钟:
1 | |
所以:bit6 和 bit2 都归 IO2 管 → 坏的是 IO2 这条数据线。
再往下看一层:所有异常字节的 bit2/bit6 全是 1(7C/C4/6C/DF、FF/ED/6F/DF、44/75/FC/5E 全部满足),而正常数据里这些位是有 0 有 1 的 → IO2 被恒定读成 1,这是”线开路/浮空被拉高”的典型特征。
最后落到器件手册:这颗 Flash 是 XM25QH64D(64Mb,SOIC-8;SMIF 配置沿用 W25Q64CV 兼容参数):
| pin | 名称 | 四线模式 |
|---|---|---|
| 1 | /CS | /CS |
| 2 | DO | IO1 |
| 3 | /WP | IO2 ← 重点 |
| 4 | GND | GND |
| 5 | DI | IO0 |
| 6 | CLK | CLK |
| 7 | /HOLD | IO3 |
| 8 | VCC | VCC |
pin 3(/WP,四线模式下就是 IO2)虚焊。
从”黑屏”到”pin 3”,中间全部是可验证的数据,没有靠猜。
异或、位映射、手册查询这些”算”的部分,也可以让 AI 一起做,人负责验证。
9. 根因与措施
根因:外部 QSPI Flash 焊接不良(pin 3 ,或整体爬锡不良/虚焊),XIP 读数据时 IO2 恒为 1,CPU 取指到非法指令 → HardFault → 看门狗复位环 → 黑屏。
11. 一句话总结
黑屏不等于软件死机。先问两个问题:CPU 停在哪?它在读什么?
这次答案分别是:HardFault 里,和一颗虚焊的 Flash。
附录 A 可能会用到的 J-Link Commander 命令
1 | |
附录 B 照片



