U8g2自定义中文字库实战：从零构建Arduino OLED专属字体

1. 为什么需要自定义U8g2中文字库

在嵌入式开发中，我们经常会遇到需要在OLED屏幕上显示中文的需求。使用U8g2库自带的完整中文字库虽然方便，但对于存储空间有限的开发板（如Arduino UNO）来说，这可能会带来严重的问题。

完整的中文字库通常包含数千个汉字，编译后会占用大量存储空间。以16x16点阵字体为例，一个汉字需要32字节存储空间，3000个常用汉字就需要近100KB的存储空间。而Arduino UNO的Flash存储只有32KB，这显然无法满足需求。

我在实际项目中就遇到过这样的情况：当使用U8g2自带的中文字库时，程序编译后提示存储空间不足。这时候就需要考虑自定义字库的方案，只包含项目实际需要的汉字，从而大幅减少存储空间占用。

2. 准备工作与环境搭建

2.1 工具与材料准备

在开始制作自定义字库前，我们需要准备以下工具和材料：

1. U8g2库源码：从GitHub下载u8g2-master.zip，这个库包含了制作字库所需的工具
2. 字体文件：Windows系统可以在C:\Windows\Fonts目录中找到，推荐使用"新宋体"(simsun.ttc)
3. GUITool工具：用于生成BDF字体文件
4. 文本编辑器：推荐使用Visual Studio Code，处理大文件更高效
5. 开发环境：Arduino IDE和U8g2库

2.2 文件目录结构

建议将所有工具和文件放在一个没有中文路径的目录中。我通常直接在D盘根目录下创建工作文件夹，结构如下：

D:\u8g2_font_tools\ ├── u8g2-master\ # 解压后的U8g2源码 ├── simsun.ttc # 字体文件 └── GUITool.exe # BDF生成工具

3. 制作自定义中文字库

3.1 确定所需汉字列表

首先需要确定项目中需要用到的所有汉字。以环境监测仪为例，可能需要显示以下内容：

"温度、湿度、甲醛、日期、星期、一、二、三、四、五、六、日、时、辰、子、丑、寅、卯、℃、："

将这些汉字整理成一个连续的字符串：

"温度湿度甲醛日期星期一二三四五六日十时辰子丑寅卯辰巳午未申酉戌亥℃："

3.2 汉字转Unicode编码

使用在线工具将中文字符串转换为Unicode编码。转换后的结果如下：

"\u6e29\u5ea6\u5e74\u6708\u65e5\u671f\u661f\u671f\u4e00\u4e8c\u4e09\u56db\u4e94\u516d\u65e5\u5341\u65f6\u8fb0\u5b50\u4e11\u5bc5\u536f\u8fb0\u5df3\u5348\u672a\u7533\u9149\u620c\u4ea5\u7ecf\u8109\u7edc\u80c6\u809d\u80ba\u5927\u80a0\u80c3\u813e\u5fc3\u5c0f\u80a0\u8180\u80f1\u80be\u5fc3\u5305\u7126\uff1a\u2103\u3001"

然后将"\u"替换为",$"，得到：

",$6e29,$5ea6,$5e74,$6708,$65e5,$671f,$661f,$671f,$4e00,$4e8c,$4e09,$56db,$4e94,$516d,$65e5,$5341,$65f6,$8fb0,$5b50,$4e11,$5bc5,$536f,$8fb0,$5df3,$5348,$672a,$7533,$9149,$620c,$4ea5,$7ecf,$8109,$80c6,$809d,$80ba,$5927,$80a0,$80c3,$813e,$5fc3,$5c0f,$80a0,$8180,$80f1,$80be,$5fc3,$5305,$7126,$ff1a,$2103,$3001"

3.3 创建.map映射文件

在u8g2-master/tools/font/build/目录下新建一个.map文件，例如health_lamp_font.map，内容如下：

32-128, $6e29,$5ea6,$5e74,$6708,$65e5,$671f,$661f,$671f,$4e00,$4e8c,$4e09,$56db,$4e94,$516d,$65e5,$5341,$65f6,$8fb0,$5b50,$4e11,$5bc5,$536f,$8fb0,$5df3,$5348,$672a,$7533,$9149,$620c,$4ea5,$7ecf,$8109,$80c6,$809d,$80ba,$5927,$80a0,$80c3,$813e,$5fc3,$5c0f,$80a0,$8180,$80f1,$80be,$5fc3,$5305,$7126,$ff1a,$2103,$3001

其中32-128表示包含ASCII字符范围，后面是我们需要的汉字Unicode编码。

3.4 生成BDF字体文件

使用GUITool工具生成BDF字体文件：

1. 打开GUITool.exe
2. 点击"其他字体"，选择simsun.ttc
3. 勾选"BDF"选项
4. 点击"工具>设置"，确认参数一致
5. 点击"生成字库"按钮

生成完成后，将output目录中的simsun_U16.bdf文件拷贝到u8g2-master/tools/font/bdf/目录下。

4. 生成U8g2字体代码

4.1 使用bdfconv工具转换

在u8g2-master/tools/font/bdfconv/目录下创建批处理文件HaPiWanChineseFont.bat，内容如下：

bdfconv.exe -v -b 0 -f 1 D:\u8g2\tools\font\bdf\simsun_U16.bdf -M D:\u8g2\tools\font\build\health_lamp_font.map -n u8g2_font_health_lamp -o u8g2_font_health_lamp_font.c -d D:\u8g2\tools\font\bdf\simsun_U16.bdf

参数说明：

• -v：打印日志信息
• -b 0：字体构建模式（0：比例）
• -f 1：生成U8g2字体格式
• -M：指定.map映射文件
• -n：字体名称
• -o：输出文件名
• -d：生成概览图片

4.2 运行批处理文件

双击运行HaPiWanChineseFont.bat，会在当前目录生成两个文件：

• u8g2_font_health_lamp_font.c：字体代码文件
• u8g2_font_health_lamp_font.tga：字体预览图片

5. 集成自定义字体到U8g2库

5.1 修改u8g2_fonts.c文件

用Visual Studio Code打开u8g2库的源文件：

1. 定位到libraries/U8g2/src/clib/u8g2_fonts.c
2. 搜索现有的中文字体定义（如u8g2_font_wqy12_t_chinese1）
3. 将生成的字体代码插入到合适位置
4. 保存文件

5.2 修改u8g2.h头文件

在libraries/U8g2/src/clib/u8g2.h中添加字体声明：

extern const uint8_t u8g2_font_health_lamp[] U8G2_FONT_SECTION("u8g2_font_health_lamp");

6. 在项目中使用自定义字体

6.1 ST7567驱动屏幕示例

#include <U8g2lib.h> U8G2_ST7567_ENH_DG128064I_1_4W_SW_SPI u8g2(U8G2_MIRROR, 13, 11, 10, 9, 8); void setup() { u8g2.begin(); u8g2.enableUTF8Print(); } void loop() { u8g2.firstPage(); do { u8g2.setFont(u8g2_font_health_lamp); u8g2.setCursor(40, 16); u8g2.print("哈皮玩"); u8g2.setFont(u8g2_font_open_iconic_weather_2x_t); u8g2.drawGlyph(3, 16, 67); u8g2.drawLine(0, 18, 128, 18); u8g2.setFont(u8g2_font_health_lamp); u8g2.drawStr(0, 30, "ABCDEF0123456789"); u8g2.setCursor(0, 46); u8g2.print("温度：28.9"); u8g2.setFont(u8g2_font_logisoso16_tf); u8g2.setCursor(80, 48); u8g2.print("°C"); u8g2.setFont(u8g2_font_health_lamp); u8g2.setCursor(0, 62); u8g2.print("湿甲醛有机挥发物"); u8g2.drawFrame(0, 0, 128, 64); } while(u8g2.nextPage()); delay(200); }

6.2 SSD1306驱动屏幕示例

#include <U8g2lib.h> U8G2_SSD1306_128X64_NONAME_F_4W_SW_SPI u8g2(U8G2_R0, 13, 11, 10, 9, 8); void setup() { u8g2.begin(); u8g2.enableUTF8Print(); } void loop() { u8g2.clearBuffer(); u8g2.setFont(u8g2_font_health_lamp); u8g2.setCursor(40, 15); u8g2.print("哈皮玩"); u8g2.setFont(u8g2_font_open_iconic_weather_2x_t); u8g2.drawGlyph(3, 16, 67); u8g2.drawLine(0, 17, 128, 17); u8g2.setFont(u8g2_font_health_lamp); u8g2.drawStr(0, 30, "ABCDEF0123456789"); u8g2.setCursor(0, 46); u8g2.print("温度：28.9"); u8g2.setFont(u8g2_font_logisoso16_tf); u8g2.setCursor(80, 48); u8g2.print("°C"); u8g2.setFont(u8g2_font_health_lamp); u8g2.setCursor(0, 62); u8g2.print("湿甲醛有机挥发物"); u8g2.drawFrame(0, 0, 128, 64); u8g2.sendBuffer(); delay(200); }

7. 常见问题与解决方案

7.1 屏幕显示不正常

可能原因：

1. 屏幕驱动类型选择错误
2. 引脚连接不正确
3. 复位引脚未连接或连接错误

解决方案：

1. 确认屏幕驱动IC型号（如ST7567、SSD1306等）
2. 根据数据手册检查引脚连接
3. 确保复位引脚正确连接并初始化

7.2 编译时存储空间不足

可能原因：

1. 自定义字库包含过多汉字
2. 程序其他部分占用过多空间

解决方案：

1. 精简汉字列表，只保留必需汉字
2. 优化程序代码，减少不必要的功能

7.3 汉字显示乱码

可能原因：

1. Unicode编码错误
2. 字体生成参数不正确

解决方案：

1. 检查.map文件中的Unicode编码是否正确
2. 重新生成BDF文件，确保字体大小和格式正确

8. 优化与进阶技巧

8.1 字体大小优化

通过调整GUITool中的字体大小参数，可以生成不同尺寸的字体。较小的字体可以节省更多空间，但可能会影响可读性。

8.2 多字体混合使用

可以在项目中同时使用多个自定义字体，针对不同显示需求选择最合适的字体。例如，标题使用较大字体，正文使用较小字体。

8.3 动态加载字体

对于存储空间特别有限的项目，可以考虑将字体存储在外部存储器（如SD卡）中，需要时动态加载。这种方法实现较复杂，但可以极大节省内部存储空间。

在实际项目中，我发现这套方案非常稳定可靠。通过自定义字库，我的环境监测仪项目成功将程序大小从原来的28KB减少到16KB，完美解决了存储空间不足的问题。