1. 项目概述
在嵌入式GUI开发中,LVGL作为一款轻量级图形库越来越受欢迎。但很多开发者在使用Keil MDK环境配合LVGL显示中文时,经常会遇到乱码、方框或黑屏等问题。本文将详细介绍如何在Keil5环境下,通过UTF-8编码设置和自定义字库生成,实现LVGL中文显示的完整解决方案。
这个方案适用于LVGL v6到v9各个版本,核心思路是通过官方字体转换工具生成精简的中文字库,并正确处理编码兼容性问题。相比网上零散的教程,本文提供的是经过实际项目验证的完整流程,包含从环境配置到问题排查的全套方法。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与工具选择
2.1 硬件与软件环境
- 开发环境:Keil MDK-ARM V5(uVision5)
- GUI库:LVGL(v6/v7/v8/v9通用)
- MCU平台:STM32系列(如STM32F103/407/429等)
- 显示设备:支持LVGL的LCD屏(如ILI9341、SSD1306等)
2.2 字体选择建议
中文字体文件的选择直接影响显示效果和资源占用:
- 思源黑体(Source Han Sans):开源字体,字形清晰,适合UI显示
- 阿里普惠体:免费商用,笔画均匀,小字号显示效果好
- 文泉驿微米黑:专为嵌入式优化的开源中文字体
提示:避免使用宋体等衬线字体,在小尺寸屏幕上显示效果较差。
2.3 资源占用评估
中文字库会显著增加Flash占用,需要合理规划:
| 字体大小 | 包含字符数 | 预计Flash占用 |
|---|---|---|
| 16px | 100个 | 30-50KB |
| 24px | 100个 | 70-100KB |
| 16px | 2000个 | 300-500KB |
对于资源有限的MCU,建议:
- 只包含实际用到的汉字
- 使用16px大小
- 启用压缩选项(Bpp=4)
3. Keil5 UTF-8编码设置详解
3.1 为什么必须使用UTF-8
LVGL内部使用UTF-8编码处理文本,而Keil默认的ANSI编码会导致:
- 中文显示为乱码
- 字符串比较出错
- 文本处理函数异常
3.2 具体设置步骤
- 打开包含中文文本的C文件(如
gui_app.c) - 点击菜单栏:File → Save As...
- 在保存对话框右下角,编码选择:"Encode in UTF-8 without signature"
- 覆盖保存原文件
3.3 关键注意事项
- 不要选择带BOM的UTF-8:BOM头会导致嵌入式系统解析异常
- 重新输入已有乱码的中文:编码转换无法修复已损坏的文本
- 工程全局设置:建议将所有涉及中文的文件都转为UTF-8
- Makefile项目:需要在编译选项中添加
--charset=UTF-8
4. LVGL字体生成与优化
4.1 使用官方字体转换器
LVGL提供的在线字体转换工具是最可靠的字库生成方式:
- 访问:https://lvgl.io/tools/fontconverter
- 上传TTF字体文件
- 配置参数:
- Font name:
font_chinese_16(自定义名称) - Size:根据屏幕选择(16/24px)
- Bpp:4(最佳清晰度/体积比)
- Compression:Enabled(减少体积)
- Characters:填写实际需要的中文(如"温度湿度设置")
- Font name:
4.2 参数选择原理
-
Bpp(Bits-per-pixel):
- 1:体积最小,但抗锯齿差
- 4:最佳平衡,推荐值
- 8:最高质量,但体积大
-
**Compre
