高通字库
版本 V1.4 · 更新于 2026-09-04

2. 获取字库芯片SDK开发包

2.1.字库芯片SDK开发包生成步骤

字库芯片 SDK 开发包通过 GT-HMI Designer 2 的“Lib 生成”功能生成，该功能由原 MindCraft 的“自动库 Lib 助手”迁移而来。请先从官网下载并安装 GT-HMI Designer 2。软件启动后可直接点击“直接使用，无需登录”。

图2-1 GT-HMI Designer 2 启动界面

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

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

图2-2 进入 Lib 生成

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

图2-3 查看编译器路径说明

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

图2-4 Keil 编译参数配置

  1. 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 构建系统自动管理，可保持为空或选择“-”。其他使用自动构建系统的开发环境也可按此处理。

图2-5 GCC 编译参数配置

步骤三：点击“生成文件”。生成成功后，点击“打开生成文件”即可查看 SDK 开发包目录。开发包包含以下文件夹：

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

2.2.Lib 生成注意事项

1.当本地编译器为 KEIL 时：

  • 编译器路径不要带中文，最后选择的目标可以通过keil编译器属性查看目标。如图2-6所示。
  • 库文件生成路径不要带中文。

2.当本地编译器为 GCC 时：

  • 编译器gcc执行文件,ar执行文件路径不要带中文。
  • 库文件输出路径同样避免使用中文。

图2-6