用CubeIDE搞定LCD12864：手把手教你移植字库并显示自定义汉字
STM32CubeIDE实战：LCD12864自定义字库开发全指南
在嵌入式设备的人机交互界面开发中，LCD12864液晶屏因其高性价比和良好的显示效果被广泛应用。但当我们需要显示特殊符号、罕见汉字或自定义图形时，内置字库往往无法满足需求。本文将带你从零开始，在STM32CubeIDE环境下实现自定义字库的完整开发流程。
1. 硬件准备与环境搭建
1.1 硬件选型与连接
LCD12864模块通常提供并行和串行两种通信方式。我们以常见的ST7920控制器串行模式为例：
典型接线方案：
- VSS → GND
- VDD → 3.3V
- RS → PA2 (数据/命令选择)
- R/W → GND (始终写入)
- E → PB10 (时钟线)
- PSB → GND (选择串行模式)
- BLA → 3.3V (背光正极)
- BLK → GND (背光负极)
提示：不同厂商的引脚定义可能略有差异，务必参考具体模块的数据手册。
1.2 CubeIDE工程配置
- 新建STM32工程（以STM32F407为例）
- 配置GPIO：
- PA1 推挽输出（CS片选）
- PA2 推挽输出（RS数据/命令选择）
- PB10 推挽输出（SCLK时钟）
- PB11 推挽输出（SDA数据）
// GPIO初始化示例 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = LCD_CS_Pin|LCD_RS_Pin; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);2. 字库原理与生成工具
2.1 点阵字库数据结构
LCD12864通常采用16×16点阵显示汉字，每个汉字需要32字节数据表示。例如"欢"字的编码：
{0x14,0x24,0x44,0x84,0x64,0x1C,0x20,0x18,0x0F,0xE8,0x08,0x08,0x28,0x18,0x08,0x00}, {0x20,0x10,0x4C,0x43,0x43,0x2C,0x20,0x10,0x0C,0x03,0x06,0x18,0x30,0x60,0x20,0x00}2.2 使用PCtoLCD2002生成字模
- 打开PCtoLCD2002，选择"字符模式"
- 设置参数：
- 取模方式：逐行式
- 取模走向：顺向
- 输出数制：十六进制
- 输入需要生成的字符，点击"生成字模"
典型设置对比：
| 参数项 | 推荐值 | 说明 |
|---|---|---|
| 点阵大小 | 16×16 | 标准汉字显示尺寸 |
| 取模方向 | 横向取模 | 与ST7920控制器兼容 |
| 字节倒序 | 否 | 保持默认字节顺序 |
3. 工程实现与代码解析
3.1 字库文件集成
将生成的字模数据存入头文件custom_font.h：
#ifndef __CUSTOM_FONT_H #define __CUSTOM_FONT_H const unsigned char HZK[][32] = { // "欢迎"字模 {0x14,0x24,...,0x20,0x00}, // 欢 {0x40,0x41,...,0x40,0x00}, // 迎 // 添加更多自定义字符... }; #endif3.2 关键驱动函数实现
串行数据写入函数：
void WriteToLCD(uint8_t data, uint8_t isCommand) { uint8_t i; CS_0; // 使能片选 if(isCommand) RS_0; // 命令模式 else RS_1; // 数据模式 for(i=0; i<8; i++) { SCLK_0; if(data & 0x80) SDA_1; else SDA_0; SCLK_1; data <<= 1; } }汉字显示函数：
void ShowChinese(uint8_t x, uint8_t y, uint8_t index) { uint8_t i,j; SetPosition(x, y); for(j=0; j<2; j++) { // 16x16汉字分上下两部分 SetPosition(x+j, y); for(i=0; i<16; i++) { WriteToLCD(HZK[index][j*16+i], 0); // 写入字模数据 } } }4. 高级应用与优化技巧
4.1 动态字库加载方案
对于需要大量自定义字符的场景，可将字库存放在外部Flash或SD卡中：
- 设计字库文件头结构：
#pragma pack(1) typedef struct { char magic[4]; // "FONT" uint16_t count; // 字符总数 uint16_t version; // 字库版本 } FontHeader;- 实现动态加载函数：
uint8_t LoadFontChar(uint32_t offset, uint8_t* buffer) { return SPI_FLASH_Read(FLASH_FONT_ADDR + offset, buffer, 32); }4.2 显示性能优化
双缓冲技术实现步骤：
- 在RAM中开辟两块显示缓冲区
- 后台操作完成所有绘制后一次性刷新到LCD
- 使用DMA传输减少CPU占用
// 显示缓冲区定义 uint8_t dispBuffer[8][128]; // 8页×128列 // DMA刷新函数 void RefreshLCD() { for(uint8_t page=0; page<8; page++) { SetPageAddress(page); SetColumnAddress(0); HAL_SPI_Transmit_DMA(&hspi1, dispBuffer[page], 128); while(HAL_SPI_GetState(&hspi1) != HAL_SPI_STATE_READY); } }5. 常见问题排查
5.1 显示异常排查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 屏幕全白 | 对比度调节不当 | 调整V0引脚电压 |
| 显示内容错位 | 初始化序列不完整 | 检查Reset时序 |
| 部分字符显示乱码 | 字模数据不匹配 | 确认取模方向设置 |
| 通信不稳定 | 时序不符合要求 | 增加延时或降低时钟频率 |
5.2 调试技巧
- 使用逻辑分析仪捕捉SPI波形，验证：
- 时钟频率是否在控制器支持范围内（通常<2MHz）
- 数据建立时间和保持时间是否满足要求
- 分段测试：
// 测试基础功能 void TestBasic() { WriteToLCD(0x20, 1); // 基本指令集 WriteToLCD(0x0C, 1); // 开显示 WriteToLCD(0x01, 1); // 清屏 }通过本方案，我们成功在STM32平台上实现了LCD12864的自定义字库显示功能。实际项目中，当需要显示设备序列号等动态内容时，这套方案相比使用图片方式可节省约70%的存储空间。