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

1. 为什么需要自定义U8g2中文字库在嵌入式开发中我们经常会遇到需要在OLED屏幕上显示中文的需求。使用U8g2库自带的完整中文字库虽然方便但对于存储空间有限的开发板如Arduino UNO来说这可能会带来严重的问题。完整的中文字库通常包含数千个汉字编译后会占用大量存储空间。以16x16点阵字体为例一个汉字需要32字节存储空间3000个常用汉字就需要近100KB的存储空间。而Arduino UNO的Flash存储只有32KB这显然无法满足需求。我在实际项目中就遇到过这样的情况当使用U8g2自带的中文字库时程序编译后提示存储空间不足。这时候就需要考虑自定义字库的方案只包含项目实际需要的汉字从而大幅减少存储空间占用。2. 准备工作与环境搭建2.1 工具与材料准备在开始制作自定义字库前我们需要准备以下工具和材料U8g2库源码从GitHub下载u8g2-master.zip这个库包含了制作字库所需的工具字体文件Windows系统可以在C:\Windows\Fonts目录中找到推荐使用新宋体(simsun.ttc)GUITool工具用于生成BDF字体文件文本编辑器推荐使用Visual Studio Code处理大文件更高效开发环境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,$30013.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字体文件打开GUITool.exe点击其他字体选择simsun.ttc勾选BDF选项点击工具设置确认参数一致点击生成字库按钮生成完成后将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库的源文件定位到libraries/U8g2/src/clib/u8g2_fonts.c搜索现有的中文字体定义如u8g2_font_wqy12_t_chinese1将生成的字体代码插入到合适位置保存文件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 屏幕显示不正常可能原因屏幕驱动类型选择错误引脚连接不正确复位引脚未连接或连接错误解决方案确认屏幕驱动IC型号如ST7567、SSD1306等根据数据手册检查引脚连接确保复位引脚正确连接并初始化7.2 编译时存储空间不足可能原因自定义字库包含过多汉字程序其他部分占用过多空间解决方案精简汉字列表只保留必需汉字优化程序代码减少不必要的功能7.3 汉字显示乱码可能原因Unicode编码错误字体生成参数不正确解决方案检查.map文件中的Unicode编码是否正确重新生成BDF文件确保字体大小和格式正确8. 优化与进阶技巧8.1 字体大小优化通过调整GUITool中的字体大小参数可以生成不同尺寸的字体。较小的字体可以节省更多空间但可能会影响可读性。8.2 多字体混合使用可以在项目中同时使用多个自定义字体针对不同显示需求选择最合适的字体。例如标题使用较大字体正文使用较小字体。8.3 动态加载字体对于存储空间特别有限的项目可以考虑将字体存储在外部存储器如SD卡中需要时动态加载。这种方法实现较复杂但可以极大节省内部存储空间。在实际项目中我发现这套方案非常稳定可靠。通过自定义字库我的环境监测仪项目成功将程序大小从原来的28KB减少到16KB完美解决了存储空间不足的问题。