沈蓁蓁STM32实战：从零构建SPI驱动OLED显示系统
开篇：为什么选择SPI驱动OLED？
在嵌入式开发中，显示界面是人机交互的重要窗口。相比传统的LCD屏幕，OLED以其自发光、高对比度、低功耗等特性，逐渐成为嵌入式项目的首选。而SPI（Serial Peripheral Interface）作为MCU与外围设备通信的"高速公路"，其高速传输特性特别适合驱动OLED这类需要频繁刷新数据的显示设备。
我曾在一个智能家居项目中尝试过多种显示方案，最终发现SPI+OLED的组合在刷新速度、接线复杂度和功耗控制上达到了完美平衡。本文将分享如何用STM32标准外设库搭建完整的SPI-OLED显示系统，包含硬件连接技巧、软件配置要点、字库制作方法以及性能优化手段。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
1. 硬件架构设计
1.1 元器件选型要点
选择OLED模块时需要注意以下参数：
- 通信接口：4线SPI（CS/DC/RES）或I2C
- 分辨率：常见128x64或128x32
- 驱动芯片：SSD1306（最广泛兼容）
- 供电电压：3.3V直接兼容STM32
推荐型号：0.96寸128x64 SPI OLED（SSD1306驱动）
1.2 硬件连接示意图
典型接线方案（以STM32F103C8T6为例）：
| OLED引脚 | STM32引脚 | 功能说明 |
|---|---|---|
| GND | GND | 地线 |
| VCC | 3.3V | 电源(3.3V) |
| D0(SCK) | PA5 | SPI时钟线 |
| D1(MOSI) | PA7 | SPI数据线 |
| RES | PB0 | 复位信号(可自定义) |
| DC | PB1 | 数据/命令选择 |
| CS | PA4 | 片选信号(可接地) |
提示：若板上只有一个SPI设备，可将CS直接接地简化控制逻辑
1.3 硬件设计注意事项
- 上拉电阻：SPI时钟线建议加1KΩ上拉
- 走线长度：SCK与MOSI线尽量等长
- 电源滤波：VCC附近放置0.1μF去耦电容
- 复位电路：RESET引脚可增加RC延迟电路
2. 软件工程配置
2.1 开发环境准备
所需工具链：
- Keil MDK-ARM或STM32CubeIDE
- STM32标准外设库或HAL库
- OLED厂商提供的驱动例程
工程目录结构示例：
code复制/Drivers
/OLED
oled.c
oled.h
oledfont.h
/User
main.c
2.2 SPI初始化关键代码
c复制void SPI_Config(void)
{
GPIO_InitTypeDef GPIO_InitStructure;
SPI_InitTypeDef SPI_InitStructure;
// 使能时钟
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI2, ENABLE);
// 配置SCK和MOSI引脚
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5 | GPIO_Pin_7;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOA, &GPIO_InitStructure);
// SPI参数配置
SPI_InitStructure.SPI_Direction = SPI_Direction_1Line_Tx;
SPI_InitStructure.SPI_Mode = SPI_Mode_Master;
SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b;
SPI_InitStructure.SPI_CPOL = SPI_CPOL_Low; // 模式0
SPI_InitStructure.SPI_CPHA = SPI_CPHA_1Edge;
SPI_InitStructure.SPI_NSS = SPI_NSS_Soft;
SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_4;
SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;
SPI_Init(SPI2, &SPI_InitStructure);
SPI_Cmd(SPI2, ENABLE);
}
2.3 OLED驱动层实现
核心数据传输函数示例：
c复制void OLED_WR_Byte(uint8_t dat, uint8_t cmd)
{