RT-Thread下用u8g2库驱动0.96寸OLED（SSD1306）显示中文，从环境搭建到字体制作全流程

RT-Thread实战：u8g2库驱动0.96寸OLED显示中文全流程解析

在嵌入式开发中，OLED屏幕因其高对比度、低功耗和体积小巧等优势，成为人机交互界面的热门选择。而要在资源有限的嵌入式系统中实现中文显示，往往让开发者感到棘手。本文将手把手带你完成在RT-Thread操作系统上，使用u8g2库驱动SSD1306芯片的0.96寸OLED屏幕，并实现中文显示的完整流程。

1. 环境准备与u8g2库集成

1.1 硬件准备清单

• 0.96寸OLED屏幕：确认型号为SSD1306驱动芯片，分辨率128x64
• 开发板：支持RT-Thread的MCU（如STM32系列）
• 连接方式：根据屏幕接口准备IIC或SPI接线
• 杜邦线：用于屏幕与开发板的物理连接

1.2 快速集成u8g2库的两种方式

方法一：使用RT-Thread软件包中心

# 在RT-Thread env环境中执行 menuconfig -> RT-Thread online packages -> peripheral libraries -> u8g2

选择最新版本保存后，工具会自动下载并集成到工程中。

方法二：GitHub源码直接集成（推荐）

1. 访问u8g2官方GitHub仓库
2. 下载仓库中的csrc文件夹全部内容
3. 将文件添加到工程目录下的libraries/u8g2文件夹
4. 在工程配置中添加头文件路径：

// RT-Thread Studio中的路径配置示例 CPPPATH += $(PRJ_ROOT_PATH)/libraries/u8g2

提示：方法二更适合需要快速启动或网络受限的环境，避免了Env工具的复杂配置。

2. 硬件连接与驱动初始化

2.1 接线示意图（以IIC为例）

2.2 驱动初始化代码

#include <u8g2_port.h> // 定义硬件IIC设备 #define OLED_I2C_NAME "i2c1" // u8g2实例结构体 static u8g2_t u8g2; void oled_init(void) { // 初始化IIC设备 rt_device_t i2c_dev = rt_device_find(OLED_I2C_NAME); if (i2c_dev == RT_NULL) { rt_kprintf("I2C device not found!\n"); return; } // 使用硬件IIC构造器 u8g2_Setup_ssd1306_i2c_128x64_noname_f( &u8g2, U8G2_R0, u8x8_byte_rtthread_hw_i2c, u8x8_gpio_and_delay_rtthread ); // 初始化显示 u8g2_InitDisplay(&u8g2); u8g2_SetPowerSave(&u8g2, 0); u8g2_ClearBuffer(&u8g2); u8g2_SendBuffer(&u8g2); }

3. 中文字库制作实战

3.1 字体转换工具链准备

1. GUItool：用于生成BDF字体文件
2. bdfconv：u8g2自带的BDF转C文件工具
3. 文本编辑器：用于编辑映射文件

3.2 详细制作步骤

步骤1：创建字符映射文件

1. 使用在线工具将需要显示的中文转换为Unicode编码
2. 创建my_font.map文件，格式如下：

32-128 $4F60$597D $4E16$754C

其中$4F60对应"你"的Unicode编码

步骤2：使用GUItool生成BDF文件

1. 打开GUItool选择Windows字体（如微软雅黑）
2. 设置参数：
   • 像素大小：16（推荐）
   • 编码方式：Unicode
   • 输出格式：BDF

步骤3：使用bdfconv转换

在u8g2的tools/font目录下创建转换脚本：

bdfconv.exe -v -b 0 -f 1 ./bdf/msyh16.bdf -M ./build/my_font.map -n u8g2_font_my_chinese -o u8g2_font_my_chinese.c

生成的关键文件结构：

u8g2_font_my_chinese.c └── 包含字体数据和映射关系

4. 中文显示实现与优化

4.1 集成自定义字体到工程

1. 将生成的.c文件添加到工程源码目录
2. 在u8g2_fonts.c末尾添加：

#include "u8g2_font_my_chinese.c"

3. 在显示代码中调用：

u8g2_SetFont(&u8g2, u8g2_font_my_chinese); u8g2_DrawUTF8(&u8g2, 10, 30, "你好世界"); u8g2_SendBuffer(&u8g2);

4.2 显示效果优化技巧

内存优化方案

// 使用局部缓冲而非全局变量 uint8_t *buf = rt_malloc(u8g2_GetBufferSize(&u8g2)); u8g2_SetBufferPtr(&u8g2, buf); // 使用后及时释放 rt_free(buf);

多语言切换实现

// 定义不同语言的字体指针 const uint8_t *fonts[] = { u8g2_font_my_chinese, u8g2_font_ncenB08_tr }; // 根据语言环境切换 u8g2_SetFont(&u8g2, fonts[language]);

5. 常见问题排查指南

5.1 显示异常排查表

5.2 性能优化建议

• 使用u8g2_Setup系列函数中的_1或_2后缀版本（非全缓冲模式）
• 减少u8g2_SendBuffer的调用频率
• 对静态内容使用u8g2_DrawXBM显示位图

6. 进阶应用：实现滚动菜单

// 简单菜单实现示例 void show_menu(u8g2_t *u8g2, const char **items, int count, int selected) { u8g2_ClearBuffer(u8g2); for(int i=0; i<count; i++) { if(i == selected) { u8g2_DrawBox(u8g2, 0, i*16, 128, 16); u8g2_SetDrawColor(u8g2, 0); } u8g2_DrawUTF8(u8g2, 5, i*16+12, items[i]); u8g2_SetDrawColor(u8g2, 1); } u8g2_SendBuffer(u8g2); }

在实际项目中，我发现将常用显示内容封装为独立组件可以大幅提高开发效率。比如创建一个oled_ui.c文件，集中管理所有显示相关的函数，通过良好的接口设计实现显示逻辑与业务逻辑的解耦。