fc011. 项目概述
在嵌入式开发中，OLED显示屏因其高对比度、低功耗和快速响应等优势，成为人机交互界面的首选方案之一。Solomon公司推出的SSD1305/SSD1306控制器驱动128×64点阵OLED，支持SPI、I2C和8位并行接口，其中SPI接口以其简单高效的特性广受欢迎。本文将详细解析如何基于STM32平台实现SPI接口的OLED驱动。
作为一位长期从事嵌入式开发的工程师，我在多个项目中都使用过这款OLED模块。相比I2C接口，SPI接口虽然多占用几个IO口，但刷新速率更高，特别适合需要频繁更新显示内容的场景。下面就从硬件连接到软件实现，完整分享我的实战经验。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 硬件连接与配置
2.1 接口定义与电气特性
SSD1305/SSD1306的SPI接口采用标准的4线制（实际使用中可简化为3线），各引脚定义如下：
-
电源部分：
- GND：必须与MCU共地
- VCC：支持3.3V或5V供电，具体需查看模块规格书。我实测多数国产模块两种电压都兼容
-
通信接口：
- D0/SCK：SPI时钟线，频率建议控制在10MHz以内
- D1/MOSI：主设备输出数据线
- DC：数据/命令选择线（关键控制信号）
- RES：复位信号（低电平有效）
- CS：片选信号（低电平有效），单设备时可固定接地
特别注意：不同厂商的模块引脚顺序可能不同，务必以实际模块的丝印或规格书为准。我曾遇到过两个看似相同的模块，引脚定义完全相反的情况。
2.2 STM32硬件连接方案
以STM32F103C8T6（BluePill开发板）为例，推荐连接方式：
| OLED引脚 | STM32连接点 | 备注 |
|---|---|---|
| GND | 任意GND | 确保低阻抗连接 |
| VCC | 3.3V | 建议使用LDO稳压 |
| D0/SCK | PA5 | SPI1_SCK |
| D1/MOSI | PA7 | SPI1_MOSI |
| RES | PA1 | 普通GPIO |
| DC | PA2 | 普通GPIO |
| CS | PA4或GND | 单设备时可固定接地 |
这种连接方式充分利用了STM32的硬件SPI接口，同时保留了必要的控制信号线。在实际布线时，建议：
- 电源线尽量短且粗，可加0.1μF去耦电容
- 信号线长度不超过15cm
- 若环境干扰大，可在SCK和MOSI上加33Ω串联电阻
2.3 SPI参数配置详解
使用STM32CubeMX配置SPI1接口时，关键参数设置如下：
c复制hspi1.Instance = SPI1;
hspi1.Init.Mode = SPI_MODE_MASTER;
hspi1.Init.Direction = SPI_DIRECTION_2LINES;
hspi1.Init.DataSize = SPI_DATASIZE_8BIT;
hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; // CPOL=0
hspi1.Init.CLKPhase = SPI_PHASE_1EDGE; // CPHA=0
hspi1.Init.NSS = SPI_NSS_SOFT;
hspi1.Init.BaudRa