STM32软件模拟SPI驱动SSD1306 OLED显示屏实战

1. 项目背景与核心需求在嵌入式开发中SPI通信是最常用的外设接口之一。但实际项目中常会遇到硬件SPI引脚被占用或需要灵活调整时序的情况这时软件模拟SPI就显得尤为重要。最近在做一个OLED显示项目时就遇到了STM32F103的硬件SPI与其他外设冲突的问题于是研究实现了通过GPIO模拟SPI驱动SSD1306的方案。SSD1306是128x64像素OLED显示屏常用的驱动芯片支持SPI和I2C两种通信方式。相比I2CSPI方式具有更高的刷新速率特别适合需要快速刷新的显示场景。通过软件模拟SPI我们可以在任意GPIO上实现通信大大提升了硬件设计的灵活性。2. 硬件连接与引脚定义2.1 所需材料清单STM32F103C8T6最小系统板0.96寸SSD1306 OLED显示屏(SPI接口)杜邦线若干USB转TTL模块(用于串口调试)2.2 引脚连接方案根据SSD1306的SPI接口定义我们需要模拟以下信号线SCLK时钟信号MOSI数据输出DC数据/命令选择RST复位信号CS片选信号(可选)在STM32F103上我选择了以下GPIO进行连接#define OLED_SCLK_PIN GPIO_Pin_6 // PB6 #define OLED_MOSI_PIN GPIO_Pin_7 // PB7 #define OLED_DC_PIN GPIO_Pin_8 // PB8 #define OLED_RST_PIN GPIO_Pin_9 // PB9 #define OLED_CS_PIN GPIO_Pin_10 // PB10(可选)注意选择GPIO时需要考虑端口速度建议使用支持50MHz输出的GPIO如GPIOB。3. 软件SPI时序实现3.1 SPI模式选择SSD1306支持SPI模式0和模式3。经过实测两种模式都能正常工作这里选择模式0(CPOL0, CPHA0)进行实现。关键时序参数时钟频率建议不超过10MHz数据采样在时钟上升沿数据变化在时钟下降沿3.2 基本信号操作函数// 设置引脚电平 #define OLED_SCLK_H() GPIO_SetBits(GPIOB, OLED_SCLK_PIN) #define OLED_SCLK_L() GPIO_ResetBits(GPIOB, OLED_SCLK_PIN) #define OLED_MOSI_H() GPIO_SetBits(GPIOB, OLED_MOSI_PIN) #define OLED_MOSI_L() GPIO_ResetBits(GPIOB, OLED_MOSI_PIN) // 延时函数(根据主频调整) static void SPI_Delay(void) { uint8_t i 2; while(i--); } // 发送一个字节 void SPI_WriteByte(uint8_t data) { uint8_t i; for(i0; i8; i) { OLED_SCLK_L(); if(data 0x80) OLED_MOSI_H(); else OLED_MOSI_L(); SPI_Delay(); OLED_SCLK_H(); data 1; SPI_Delay(); } }4. SSD1306驱动实现4.1 初始化序列SSD1306需要按照特定顺序发送初始化命令void OLED_Init(void) { OLED_RST_L(); DelayMs(100); OLED_RST_H(); OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); // 设置时钟分频 OLED_WriteCmd(0x80); OLED_WriteCmd(0xA8); // 设置多路复用率 OLED_WriteCmd(0x3F); // 更多初始化命令... OLED_WriteCmd(0xAF); // 开启显示 }4.2 数据/命令发送函数void OLED_WriteCmd(uint8_t cmd) { OLED_DC_L(); // 命令模式 if(OLED_CS_PIN ! 0) OLED_CS_L(); SPI_WriteByte(cmd); if(OLED_CS_PIN ! 0) OLED_CS_H(); } void OLED_WriteData(uint8_t data) { OLED_DC_H(); // 数据模式 if(OLED_CS_PIN ! 0) OLED_CS_L(); SPI_WriteByte(data); if(OLED_CS_PIN ! 0) OLED_CS_H(); }5. 显示功能实现5.1 显存管理SSD1306内部没有显存需要MCU维护一个显示缓冲区uint8_t OLED_GRAM[128][8]; // 128x64分辨率每页8行 void OLED_Refresh(void) { uint8_t i,j; for(i0;i8;i) { OLED_WriteCmd(0xB0i); // 设置页地址 OLED_WriteCmd(0x00); // 设置列地址低4位 OLED_WriteCmd(0x10); // 设置列地址高4位 for(j0;j128;j) { OLED_WriteData(OLED_GRAM[j][i]); } } }5.2 基本绘图函数// 设置像素点 void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t color) { if(x128 || y64) return; if(color) OLED_GRAM[x][y/8] | 1(y%8); else OLED_GRAM[x][y/8] ~(1(y%8)); } // 显示字符 void OLED_ShowChar(uint8_t x, uint8_t y, char chr, uint8_t size) { uint8_t i,j,temp; uint8_t *pfont (uint8_t *)ASCII_Font[(chr- )*size]; for(i0;isize;i) { temp *pfont; for(j0;j8;j) { if(temp 0x80) OLED_DrawPoint(xi, yj, 1); else OLED_DrawPoint(xi, yj, 0); temp 1; } } }6. 性能优化技巧6.1 时序优化通过调整延时函数可以提升通信速率// 使用寄存器操作替代库函数 #define OLED_SCLK_H() (GPIOB-BSRR GPIO_Pin_6) #define OLED_SCLK_L() (GPIOB-BRR GPIO_Pin_6) // 内联汇编实现精确延时 static __inline void SPI_Delay(void) { __asm volatile ( nop \n nop \n nop \n nop \n ); }6.2 局部刷新只刷新显存中变化的部分可以大幅提高刷新效率void OLED_PartialRefresh(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2) { uint8_t i,j; for(iy1/8; iy2/8; i) { OLED_WriteCmd(0xB0i); OLED_WriteCmd(x1 0x0F); OLED_WriteCmd(0x10 | (x1 4)); for(jx1; jx2; j) { OLED_WriteData(OLED_GRAM[j][i]); } } }7. 常见问题与解决方案7.1 显示乱码可能原因时序不符合要求检查时钟极性和相位设置初始化序列错误严格按照数据手册顺序发送命令电源不稳定确保3.3V供电充足7.2 刷新闪烁解决方法使用双缓冲机制降低刷新频率优化刷新区域7.3 通信失败排查步骤用逻辑分析仪抓取波形检查GPIO初始化是否正确确认上电时序符合要求8. 实际应用案例8.1 嵌入式菜单系统通过软件SPI驱动OLED可以实现丰富的用户界面typedef struct { char *text; void (*action)(void); } MenuItem; void ShowMenu(MenuItem *menu, uint8_t count) { uint8_t i; OLED_Clear(); for(i0; icount; i) { OLED_ShowString(10, i*8, menu[i].text); } OLED_Refresh(); }8.2 实时数据监控适合显示传感器数据void UpdateSensorData(float temp, float humi) { char buf[16]; sprintf(buf, Temp:%.1fC, temp); OLED_ShowString(0, 0, buf); sprintf(buf, Humi:%.1f%%, humi); OLED_ShowString(0, 16, buf); OLED_PartialRefresh(0, 0, 127, 23); }在实现过程中发现软件SPI虽然占用CPU资源较多但在STM32F103上仍能实现足够快的刷新率。通过合理优化可以达到30fps以上的全屏刷新率完全满足大多数嵌入式显示需求。