7. 库文件生成与资料下载
一个隐性高频原因：库文件与芯片型号、编译器不匹配——初始化"成功"但取模全 0（见4.3 Q07）。这一章解决"库怎么来、资料哪里下"。
7.1 Q08 怎么为指定 MCU 生成库文件
现象
为特定平台请求库文件，例如 GT30L24A3W + STM32F767（Cortex-M7）；CH32V307VC + GT20L16S1Y（MounRiver Studio）；字库芯片接 S32K312 等。
解决办法
- 用官方库生成工具 GT-HMI Designer2 生成，操作方法见字库 Lib 生成工具使用指南；生成失败或型号不在列表，提交 FAE 处理。
- 注意：
- ARMCC / GCC / IAR 的库不通用；
- CH32V307 是 RISC-V 内核，需 RISC-V GCC 库；
- Cortex-M7（STM32F767 / S32K312）注意浮点 ABI 与编译选项。
验证方法
生成的库文件与型号、编译器两者都对上后再接入工程；接入后用数据验证表读 A 验证。
7.2 Q09 GCC 和 ARM 该选哪种库
现象
编译器是 GCC，询问选哪种库文件；或问"lib 助手是否不支持生成 GCC 的库文件""导出字库时 gcc 和 ar 怎么选"。
解决办法
- 用官方库生成工具 GT-HMI Designer2 生成对应编译器的库，见字库 Lib 生成工具使用指南；生成失败则提交 FAE。
- 不要混用不同工具链的库。
- 换编译器必须重新生成 / 重新选择库。
验证方法
接入工程后编译无符号缺失告警；取模结果与数据验证表一致。
7.3 Q10 驱动、头文件、开发资料在哪里下载
现象
找特定型号的库头文件、驱动、开发资料（如 gt21l16s2w 库头文件、GT22L16M1Y 驱动、GT24L24A2W16 开发资料）；或问是否有字库芯片内部 Flash 的读写库；或在 MindCraft 获取 GT5SLAD2E-1A 资料时提示错误。
解决办法
- 官网文档中心 / 产品页面下载，入口汇总：
- 字库芯片详细使用指南——驱动流程、SDK、API、显示；
- 字库芯片开发资料——含通过 MindCraft 应用生成型号资料的步骤与下载链接；
- 字库芯片规格书——指令、时序、电气参数；
- 型号专属资料：GT-HMI Designer2 / MindCraft 按型号生成。
- GT-HMI Designer2 上位机报错时：
- 确认软件版本最新、型号选择正确；
- 以管理员运行；路径不含中文 / 空格；
- 检查网络、防火墙 / 杀毒拦截；
- 关闭占用文件的程序，清理缓存；
- 重装或换机器交叉验证；
- 收集版本、系统、型号、操作步骤、报错截图 / 日志提交 FAE。
验证方法
下载的资料包按字库芯片开发资料 · 资料描述核对目录结构，确认与型号一致。