手把手教你用STM32CubeMX和HAL库驱动0.91寸OLED（SSD1306），从点亮到画图全流程

STM32CubeMX与HAL库驱动0.91寸OLED全流程实战指南

1. 硬件准备与连接

0.91寸OLED模块（SSD1306驱动）因其体积小巧、功耗低、接口简单等特点，成为嵌入式开发的理想显示方案。在开始软件配置前，我们需要确保硬件连接正确无误。

典型硬件连接方案：

注意：I2C模式下OLED地址通常为0x78或0x7A，可通过模块背面电阻配置

常见问题排查：

• 屏幕无反应：检查电源电压是否稳定在3.3V
• 显示乱码：确认I2C/SPI速率不超过400kHz（I2C）或10MHz（SPI）
• 部分区域不显示：检查连接线是否虚焊

2. STM32CubeMX工程配置

2.1 创建基础工程

1. 打开STM32CubeMX，选择对应STM32型号（如STM32F103C8T6）
2. 配置系统时钟（推荐使用外部晶振+HSE）
3. 设置调试接口（SWD/JTAG）

2.2 接口模式选择

根据硬件连接选择通信接口：

I2C模式配置：

// 在Pinout界面启用I2C1 // 参数设置： // Timing: Standard Mode (100kHz) // 或Fast Mode (400kHz) // Address: 0x78 (7位地址模式)

SPI模式配置：

// 在Pinout界面启用SPI1 // 参数设置： // Mode: Full-Duplex Master // Prescaler: /8 (约9MHz @72MHz系统时钟) // CPOL: Low, CPHA: 1 Edge

2.3 GPIO配置技巧

• 复位引脚（如有）：配置为GPIO_Output
• DC引脚（SPI模式）：配置为GPIO_Output
• 添加用户标签方便代码阅读：

  // 在CubeMX中右键引脚→Enter User Label // 如"OLED_RESET", "OLED_DC"等

3. HAL库驱动实现

3.1 工程文件结构

建议采用模块化设计：

/Drivers /OLED oled.c oled.h font.h /Inc /fonts font8x6.h font16x8.h

3.2 核心驱动函数

初始化序列：

void OLED_Init(void) { HAL_Delay(100); // 硬件复位延时 OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); // 设置时钟分频 OLED_WriteCmd(0x80); // 建议值 OLED_WriteCmd(0xA8); // 多路复用比例 OLED_WriteCmd(0x3F); // 64-1 // ...其他初始化命令 OLED_WriteCmd(0xAF); // 开启显示 }

I2C写入函数优化：

void OLED_WriteCmd(uint8_t cmd) { uint8_t buf[2] = {0x00, cmd}; HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDRESS, buf, 2, 10); } void OLED_WriteData(uint8_t data) { uint8_t buf[2] = {0x40, data}; HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDRESS, buf, 2, 10); }

3.3 显示功能实现

字符显示函数：

void OLED_ShowChar(uint8_t x, uint8_t y, char chr, uint8_t size) { uint8_t c = chr - ' '; if(size == 16) { OLED_SetPos(x, y); for(uint8_t i=0; i<8; i++) OLED_WriteData(F8X16[c*16+i]); OLED_SetPos(x, y+1); for(uint8_t i=0; i<8; i++) OLED_WriteData(F8X16[c*16+i+8]); } else { OLED_SetPos(x, y); for(uint8_t i=0; i<6; i++) OLED_WriteData(F6x8[c][i]); } }

图形绘制函数：

// Bresenham画线算法实现 void OLED_DrawLine(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2) { int16_t dx = abs(x2-x1), sx = x1<x2 ? 1 : -1; int16_t dy = -abs(y2-y1), sy = y1<y2 ? 1 : -1; int16_t err = dx+dy, e2; while(1){ OLED_DrawPixel(x1, y1); if(x1==x2 && y1==y2) break; e2 = 2*err; if(e2 >= dy) { err += dy; x1 += sx; } if(e2 <= dx) { err += dx; y1 += sy; } } }

4. 高级功能与优化

4.1 双缓冲技术

uint8_t oled_buffer[8][128]; // 显存缓冲区 void OLED_Refresh(void) { for(uint8_t page=0; page<8; page++) { OLED_WriteCmd(0xB0 + page); // 设置页地址 OLED_WriteCmd(0x00); // 列地址低4位 OLED_WriteCmd(0x10); // 列地址高4位 for(uint8_t col=0; col<128; col++) { OLED_WriteData(oled_buffer[page][col]); } } }

4.2 中文显示支持

1. 制作字模数据（推荐使用PCtoLCD2002工具）
2. 在font.h中添加汉字字库：

const unsigned char HZK16[][32] = { {0x00,0x00,0x3F,0x20,0x20,0x20,0x20,0x20,...}, // 汉字1 {0x00,0x00,0xFE,0x02,0x02,0x02,0x02,0x02,...} // 汉字2 };

4.3 低功耗优化

void OLED_SleepMode(uint8_t enable) { if(enable) { OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0x8D); // 关闭电荷泵 OLED_WriteCmd(0x10); } else { OLED_WriteCmd(0x8D); // 开启电荷泵 OLED_WriteCmd(0x14); OLED_WriteCmd(0xAF); // 开启显示 } }

5. 实战案例：构建UI框架

5.1 菜单系统实现

typedef struct { char *text; void (*action)(void); } MenuItem; MenuItem mainMenu[] = { {"温度监测", showTemp}, {"设置参数", enterSetting}, {"关于系统", showAbout} }; void showMenu(uint8_t selected) { OLED_Clear(); for(uint8_t i=0; i<3; i++) { if(i == selected) OLED_ShowString(10, i*2, ">", 16, 1); OLED_ShowString(20, i*2, mainMenu[i].text, 16, 1); } }

5.2 动画效果实现

void OLED_ScrollHorizontal(uint8_t dir, uint8_t start, uint8_t end) { OLED_WriteCmd(dir ? 0x26 : 0x27); // 滚动方向 OLED_WriteCmd(0x00); // 虚拟页 OLED_WriteCmd(start); // 起始页 OLED_WriteCmd(0x00); // 间隔时间 OLED_WriteCmd(end); // 结束页 OLED_WriteCmd(0x00); // 虚拟列 OLED_WriteCmd(0xFF); // 虚拟列 OLED_WriteCmd(0x2F); // 启动滚动 }

6. 调试技巧与性能优化

常见问题解决方案：

性能优化建议：

1. 减少全局刷新：仅更新变化区域
2. 使用DMA传输（SPI模式）：

HAL_SPI_Transmit_DMA(&hspi1, buffer, sizeof(buffer));

3. 精简字体数据：只包含项目所需字符
4. 合理使用硬件加速：STM32的CRC模块可校验显示数据

通过本指南的系统学习，开发者可以快速掌握OLED驱动的核心要点，在实际项目中灵活应用。建议从基础显示功能开始，逐步实现更复杂的图形界面，最终构建出稳定高效的嵌入式显示解决方案。