1. 使用指南

嵌入式 GUI 开发中，把字库芯片接入自己的工程，最麻烦的一步往往是拿到与编译环境匹配的 lib 库文件：手工搭建交叉编译链、核对编译参数，费时且容易出错。高通字库芯片配套 PC 端工具 GT-HMI Designer 2 内置「Lib 生成」功能（由原 MindCraft「自动库 Lib 助手」迁移而来），可根据本地编译环境一键生成字库芯片 SDK 开发包，自动完成 lib 库文件的编译，输出与工程完全匹配的库文件。

无论您使用 Keil（Keil4 / Keil5）、GCC 还是 IAR（仅支持 32 位处理器架构），都可以在图形界面中完成参数配置，几分钟内拿到包含驱动代码、API 库文件、参考资料在内的完整 SDK 开发包，直接开始字库芯片的开发调试。

1.1 准备工作

请先从官网下载并安装 GT-HMI Designer 2（下载地址）。软件启动后可直接点击「直接使用，无需登录」。

图1 GT-HMI Designer 2 启动界面

注意：Lib 生成支持 Keil4、Keil5、GCC 和 IAR（IAR 仅支持 32 位处理器架构）。如果使用的编译器不在支持范围内，或者字库芯片丝印批次号前四位小于 2240，请拨打 0755-83453881 联系业务或技术人员，获取对应字库的 API 函数库。

1.2 生成步骤

步骤一： 在 GT-HMI Designer 2 顶部菜单中点击「字库芯片」，然后在左侧选择「Lib 生成」。

图2 进入 Lib 生成

步骤二： 依次选择字库型号、处理器架构位数和本地编译器，再按界面提示配置编译器路径、工程参数和库文件生成路径。将鼠标停留在字段后的提示图标上，可查看对应的路径选择说明。

图3 查看编译器路径说明

Keil 参数配置：可选择导入 Keil 工程路径，导入后相关参数会自动填写；未导入工程时，请按当前工程的编译配置手动选择。通常需勾选「MicroLib」「uC99」「One ELF Section per Function」。

图4 Keil 编译参数配置

GCC 参数配置：选择 gcc 和 ar 执行文件路径，并根据工程实际编译参数设置 CPU 架构（-mcpu）、C 语言标准（-std）、浮点运算（-mfloat-abi）、优化等级（-O）及自定义编译选项（如 -mthumb、-mlongcalls）。

特别注意：使用 ESP-IDF 开发框架（涵盖 Xtensa 架构的 ESP32/S2/S3 及 RISC-V 架构的 ESP32-C3/C6/H2）时，GCC 编译参数通常由 ESP-IDF 构建系统自动管理，可保持为空或选择「-」。其他使用自动构建系统的开发环境也可按此处理。

图5 GCC 编译参数配置

步骤三： 点击「生成文件」。生成成功后，点击「打开生成文件」即可查看 SDK 开发包目录。

图6 SDK 开发包目录结构

开发包包含以下文件夹：

01_参考资料：多个国家的文字 Unicode 编码范围、技术支持相关视频，以及如何在 STM32 上使用高通字库的文档。
02_硬件资料：字库芯片的规格书、选型表。
03_SPI驱动：硬件 SPI、模拟 SPI 参考代码。
04_字库API使用：字库的 lib 文件、h 文件、字库 readme 文件。
05_屏幕显示资料：各种功能的代码示例，例如横竖转换、获取字符实际宽度等。

1.3 Lib 生成注意事项

当本地编译器为 Keil 时：
- 编译器路径不要带中文，最后选择的目标可以通过 Keil 编译器属性查看，如图 7 所示。
- 库文件生成路径不要带中文。
当本地编译器为 GCC 时：
- 编译器 gcc 执行文件、ar 执行文件路径不要带中文。
- 库文件输出路径同样避免使用中文。

图7 编译器路径查看方式

1.4 获取帮助

立即体验：下载 GT-HMI Designer 2，使用「Lib 生成」一键生成您的字库芯片 SDK 开发包。
软件使用问题可点击软件右上方的「联系我们」选项卡，查看高通字库交流群、GT-HMI 交流群、电话及邮箱等信息。
批量获取字库 API 函数库或其他技术支持，请拨打 0755-83453881。