1. 使用说明与现象速查
按现象定位的 16 个高频问题与解决办法 · 高通字库 GT 系列（点阵 / 矢量 / 灰度字库芯片）
1.1 这本手册怎么用
这本手册收录字库芯片技术支持中出现频率最高的 16 个问题，按"你看到的现象"组织：从"读不到数据""显示乱码""初始化失败"这些现场表现出发，直接跳到对应条目，每条按"现象—原因—解决办法—验证"展开。
排查前先明确手边三份资料与本手册的分工：
| 资料 | 回答的问题 |
|---|---|
| 字库芯片详细使用指南 | 从零开始怎么用（正向教程） |
| 字库芯片开发资料 | SPI 驱动代码、库文件使用、排置与显示函数 |
| 字库芯片规格书 | 指令、时序、电气参数（具体数值以此为准） |
| 本手册 | 出了问题怎么查（反向排障） |
文中指令、地址、时序、电气参数均为通用排查思路，具体数值以对应型号最新数据手册和 SDK 头文件为准。
1.2 现象速查表
按你看到的现象找行，"详见"列直达对应条目：
| 你看到的现象 | 最可能的原因 | 先做什么 | 详见 |
|---|---|---|---|
| 四根线都无波形 | 程序没执行到、引脚复用、SPI 未使能 | 测 MCU 端、翻转 GPIO 验证 | Q03 四根线都没有波形 |
| 有波形但读回全 FF | CS 未选中、MISO 未接、未供电、虚焊 | 查 CS、供电、焊接 | Q04 读 0x9F 返回异常 |
| 读 ID 正常、读字模异常 | 地址 / 指令 / dummy / 排置不匹配 | 用数据验证表核对 | Q04 / Q15 点阵值不符 |
| 数据整体移位 | CPHA、位序不对 | 改 SPI 模式 | Q04 |
| 偶发误码 | 速率过高、干扰、上拉缺失 | 先降速再排查 | Q01 SPI 最高速率 |
| Flash 能读、字库芯片不能读 | 总线冲突、CS 未独立 | 两颗 CS 独立 + 上拉 | Q02 与 Flash 共用总线 |
| 初始化返回失败 | 底层读不通、库型号不匹配 | 先用 0x9F 验证底层 | Q05 / Q06 |
| 初始化返回成功但字模全 0 | 库与型号不匹配 | 读固定地址数据验证 | Q07 返回 0 但全 0 |
| 屏幕上的字"张冠李戴" | 编码转换错误 | 核对 UTF-8 → GBK 链路 | Q12 UTF-8 怎么转 GB |
| 字形左右镜像 / 上下翻转 / 旋转 | 排置、位序不匹配 | 对照排置说明与横竖转换 | Q15 图像不对 |
| 想要 32 点阵大字号效果 | 16 点阵没有 32×32 细节 | 选含 32 点阵或矢量字库的型号 | Q14 16 点阵显 32 点阵 |
| 找不到库文件 / 驱动 / 资料 | 工具与下载入口不熟 | GT-HMI Designer2 生成 / 文档中心下载 | Q08 生成库文件 / Q10 资料下载 |
1.3 排查五原则
- 先分层：供电与硬件 → SPI 通信 → 库与初始化 → 编码与地址 → 字模与显示。一层查完再进下一层。
- 先读 ID，再读字模：读不到 ID，不要查编码和显示。
- 先降速，再提速：任何通信异常，先把 SPI 降到 1MHz 以下。
- 先对比，再修改：换型号 / 换库后，先读同一字符的点阵做十六进制对比。
- 用波形说话：尽量用逻辑分析仪抓 CS、CLK、MOSI、MISO 四通道。
经验：客户反馈"读不出数据"，绝大多数最终定位在 SPI 配置、片选、接线或库型号不匹配，芯片本身损坏的比例很低。