8. 附录：排查清单与资料索引
8.1 现场排查清单（可打印）
带到现场逐项勾选。
硬件
- VCC 电压正确、纹波 < 100mV
- VCC 就近 0.1μF 去耦
- GND 共地、地线短粗
- CS 有 10kΩ 上拉
- 所有从设备 CS 空闲为高
- 无连锡 / 虚焊 / 错位
- 5V MCU 已做电平转换
- 排线 < 10cm，非杜邦线
SPI
- 模式 0 或 3（按手册）
- MSB first
- 调试速率 ≤ 1MHz
- CS 建立 / 保持时间足够
- 字节间 CS 保持低
- 指令 / 地址 / dummy 正确
- MISO 在采样沿稳定
软件
-
gt_read_data能读 ID / 固定地址 - 库与芯片型号匹配
-
GT_Font_Init返回值符合预期 - 取模缓冲区非全 0
- 编码转换正确
- 地址计算正确
- 排置 / 位序与显示函数匹配
- 多任务有互斥
显示
- 宽高 / 步长正确
- 坐标原点 / 扫描方向正确
- 字体包含目标字符
- 字号受支持
- 灰度 / 点阵格式匹配
8.2 术语表
| 术语 | 说明 |
|---|---|
| 点阵字库 | 以位图形式存储字符，每个字号一套数据 |
| 矢量字库 | 以轮廓 / 压缩字形存储，可按字号渲染 |
| 灰度字库 | 带灰阶的字形数据，支持抗锯齿 |
| 字模 | 单个字符的点阵 / 灰度数据 |
| 内码 | 字符在特定编码中的数值，如 GBK 双字节 |
| 排置 | 点阵取模方向与排列方式（横置 / 竖置、横排 / 竖排） |
| 1bpp | 每像素 1 bit，单色 |
| dummy | 快速读取时插入的空时钟周期 |
| CS | 片选信号，低有效 |
| MISO/SO | 主入从出，字库芯片输出数据 |
| MOSI/SI | 主出从入，字库芯片接收数据 |
| JEDEC ID | 标准 SPI Flash 读 ID 指令（0x9F）返回的标识 |
| LSB/MSB | 最低位 / 最高位，位序 |
| RTL | 从右到左排版，如阿拉伯语、希伯来语 |
8.3 资料索引
| 资料 | 用途 | 获取方式 |
|---|---|---|
| 字库芯片详细使用指南 | 驱动流程、SDK、API、显示 | 文档中心 |
| 字库芯片规格书 | 指令、时序、电气参数 | 文档中心 |
| 字库芯片开发资料 | SPI 驱动代码、库使用、排置与显示函数、数据验证表 | 文档中心 |
| 字库 Lib 生成工具使用指南 | 按编译器 / 型号生成库 | 文档中心 |
| LVGL 移植高通字库 | LVGL 对接与示例 | 文档中心 |
| GT-HMI Designer2 与 GUI 框架下载 | 库生成工具获取 | 官网工具页 |
| 选型手册 / 参考工程 | 字符集、字号、排置、封装；STM32/ESP32 等平台示例 | 官网 / FAE |
8.4 版本记录
| 版本 | 日期 | 修改内容 | 编制 |
|---|---|---|---|
| V1.0 | 2026-11-03 | 首次发布：16 个高频问题，按现象分章组织 | 技术支持 |
本文档为技术支持资料，涉及具体型号的参数以最新数据手册为准。