STM32实战：从零构建SPI驱动OLED显示系统

开篇：为什么选择SPI驱动OLED？

在嵌入式开发中，显示界面是人机交互的重要窗口。相比传统的LCD屏幕，OLED以其自发光、高对比度、低功耗等特性，逐渐成为嵌入式项目的首选。而SPI（Serial Peripheral Interface）作为MCU与外围设备通信的"高速公路"，其高速传输特性特别适合驱动OLED这类需要频繁刷新数据的显示设备。

我曾在一个智能家居项目中尝试过多种显示方案，最终发现SPI+OLED的组合在刷新速度、接线复杂度和功耗控制上达到了完美平衡。本文将分享如何用STM32标准外设库搭建完整的SPI-OLED显示系统，包含硬件连接技巧、软件配置要点、字库制作方法以及性能优化手段。

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为例）：

提示：若板上只有一个SPI设备，可将CS直接接地简化控制逻辑

1.3 硬件设计注意事项

1. 上拉电阻：SPI时钟线建议加1KΩ上拉
2. 走线长度：SCK与MOSI线尽量等长
3. 电源滤波：VCC附近放置0.1μF去耦电容
4. 复位电路：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)
{
    if(cmd)
        OLED_DC_Set();  // 命令模式
    else
        OLED_DC_Clr();  // 数据模式
        
    while(SPI_I2S_GetFlagStatus(SPI2, SPI_I2S_FLAG_TXE) == RESET);
    SPI_I2S_SendData(SPI2, dat);
    while(SPI_I2S_GetFlagStatus(SPI2, SPI_I2S_FLAG_RXNE) == RESET);
    SPI_I2S_ReceiveData(SPI2);
}

3. 显示功能开发

3.1 基础显示功能

实现文本显示的基本流程：

1. 设置显示坐标
2. 写入显示数据
3. 更新显存
4. 刷新屏幕

c复制void OLED_ShowChar(uint8_t x, uint8_t y, char chr)
{
    uint8_t c = chr - ' ';
    if(x > Max_Column-1){x=0; y++;}
    OLED_Set_Pos(x, y);
    for(uint8_t i=0; i<8; i++)
        OLED_WR_Byte(font8x8[c][i], OLED_DATA);
}

3.2 中文显示实现

中文显示需要预先制作字库，推荐使用PCtoLCD2002取模软件：

取模配置参数：

• 取模方式：逐行式
• 取模走向：逆向（低位在前）
• 字体大小：16x16
• 输出格式：C51十六进制

生成的字体数据存入oledfont.h：

c复制const uint8_t F16x16_CN[] = {
    /*"中"*/
    0x00,0x40,0x20,0x50,0x4F,0xC8,0x48,0x48,
    0x48,0x48,0x48,0x4F,0xC8,0x00,0x00,0x00,
    0x00,0x00,0x00,0x00,0x00,0xFF,0x00,0x00,
    0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,
    /*"文"*/
    0x00,0x00,0x00,0xF8,0x00,0x00,0xFF,0x00,
    0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
    0x80,0x40,0x30,0x0F,0x00,0x00,0xFF,0x00,
    0x02,0x04,0x08,0x10,0x20,0xC0,0x00,0x00
};

3.3 高级显示效果

实现屏幕滚动动画：

c复制void OLED_Scroll_Horizontal(uint8_t direction)
{
    OLED_WR_Byte(0x2E, OLED_CMD); // 关闭滚动
    OLED_WR_Byte(direction, OLED_CMD); // 0x26右滚, 0x27左滚
    OLED_WR_Byte(0x00, OLED_CMD); // 虚拟字节
    OLED_WR_Byte(0x00, OLED_CMD); // 起始页
    OLED_WR_Byte(0x07, OLED_CMD); // 滚动时间间隔
    OLED_WR_Byte(0x07, OLED_CMD); // 结束页
    OLED_WR_Byte(0x00, OLED_CMD); // 虚拟字节
    OLED_WR_Byte(0xFF, OLED_CMD); // 虚拟字节
    OLED_WR_Byte(0x2F, OLED_CMD); // 开启滚动
}

4. 性能优化技巧

4.1 显存管理策略

采用双缓冲机制可显著提高刷新效率：

1. 在RAM中开辟显示缓冲区
2. 所有绘图操作先在缓冲区完成
3. 最后一次性写入OLED显存

c复制uint8_t oled_buffer[128][8]; // 128x64分辨率缓冲

void OLED_Refresh(void)
{
    for(uint8_t page=0; page<8; page++){
        OLED_Set_Pos(0, page);
        for(uint8_t col=0; col<128; col++){
            OLED_WR_Byte(oled_buffer[col][page], OLED_DATA);
        }
    }
}

4.2 SPI时钟优化

通过调整预分频器提高传输速率：

4.3 低功耗设计

OLED省电模式配置：

c复制void OLED_PowerSave(uint8_t mode)
{
    if(mode){
        OLED_WR_Byte(0xAE, OLED_CMD); // 关闭显示
        OLED_WR_Byte(0x8D, OLED_CMD); // 关闭电荷泵
    }else{
        OLED_WR_Byte(0x8D, OLED_CMD); 
        OLED_WR_Byte(0x14, OLED_CMD); // 开启电荷泵
        OLED_WR_Byte(0xAF, OLED_CMD); // 开启显示
    }
}

5. 常见问题排查

5.1 显示异常排查流程

1. 检查电源：测量VCC电压(3.3V±0.3V)
2. 验证复位时序：RESET低电平脉冲>3μs
3. 确认SPI信号：
   • 用逻辑分析仪捕捉SCK/MOSI波形
   • 检查时钟极性(CPOL)和相位(CPHA)设置
4. 测试基础指令：

   c复制OLED_WR_Byte(0xAF, OLED_CMD); // 开启显示
   OLED_WR_Byte(0xA4, OLED_CMD); // 正常显示模式
   

5.2 典型问题解决方案

问题1：屏幕仅显示乱码

• 检查字库数据是否匹配显示函数
• 确认取模方向与代码解析一致
• 测试ASCII字符显示是否正常

问题2：显示内容闪烁

• 降低SPI时钟频率尝试
• 增加去耦电容(0.1μF靠近VCC)
• 检查电源负载能力

问题3：通信不稳定

• 缩短连接线长度(<20cm)
• 为SCK增加上拉电阻(1-10KΩ)
• 尝试改用软件SPI驱动

6. 项目实战扩展

6.1 多级菜单实现

采用状态机设计菜单系统：

c复制typedef struct {
    char *text;
    void (*action)(void);
    struct MenuItem *children;
    uint8_t child_count;
} MenuItem;

MenuItem mainMenu[] = {
    {"系统设置", NULL, settingsMenu, 3},
    {"数据显示", showData, NULL, 0},
    {"设备信息", showInfo, NULL, 0}
};

void Menu_Handler(uint8_t key)
{
    static uint8_t current = 0;
    switch(key){
        case KEY_UP: 
            current = (current-1)%itemCount;
            break;
        case KEY_DOWN:
            current = (current+1)%itemCount;
            break;
        case KEY_ENTER:
            if(menu[current].action) 
                menu[current].action();
            break;
    }
    OLED_ShowMenu(current);
}

6.2 动态图表绘制

实现实时波形显示：

c复制void Draw_Waveform(int16_t *data, uint8_t count)
{
    OLED_ClearBuffer();
    // 绘制坐标轴
    Draw_Line(10, 10, 10, 54, 1);
    Draw_Line(10, 54, 118, 54, 1);
    
    // 绘制波形
    for(uint8_t i=0; i<count-1; i++){
        int16_t y1 = 54 - (data[i]/16);
        int16_t y2 = 54 - (data[i+1]/16);
        Draw_Line(20+i*2, y1, 20+(i+1)*2, y2, 1);
    }
    OLED_Refresh();
}

6.3 多语言支持方案

构建国际化字库系统：

c复制typedef struct {
    uint16_t unicode;
    uint8_t width;
    uint8_t height;
    const uint8_t *data;
} FontChar;

const FontChar fontLib[] = {
    {0x4E2D, 16, 16, F16x16_CN_1}, // "中"
    {0x6587, 16, 16, F16x16_CN_2}, // "文"
    {0x0041, 8, 16, F8x16_EN_A},   // "A"
    // 更多字符...
};

const uint8_t* Find_Font(uint16_t unicode)
{
    for(uint32_t i=0; i<sizeof(fontLib)/sizeof(FontChar); i++){
        if(fontLib[i].unicode == unicode)
            return fontLib[i].data;
    }
    return NULL;
}

7. 进阶开发方向

7.1 硬件加速方案

利用STM32的DMA功能释放CPU资源：

c复制void OLED_Refresh_DMA(void)
{
    OLED_Set_Pos(0, 0);
    DMA_Cmd(DMA1_Channel5, DISABLE);
    DMA_SetCurrDataCounter(DMA1_Channel5, 1024); // 128x64/8
    DMA_Cmd(DMA1_Channel5, ENABLE);
    
    SPI_I2S_DMACmd(SPI2, SPI_I2S_DMAReq_Tx, ENABLE);
    while(DMA_GetFlagStatus(DMA1_FLAG_TC5) == RESET);
    SPI_I2S_DMACmd(SPI2, SPI_I2S_DMAReq_Tx, DISABLE);
    DMA_ClearFlag(DMA1_FLAG_TC5);
}

7.2 无线显示系统

通过ESP8266实现远程内容更新：

c复制void ESP8266_Process(void)
{
    if(UART_Receive_JSON(&json)){
        OLED_ClearBuffer();
        if(json.type == TEXT){
            OLED_ShowString(json.x, json.y, json.data, json.size);
        }else if(json.type == GRAPH){
            OLED_DrawBMP(json.x, json.y, json.w, json.h, json.data);
        }
        OLED_Refresh();
    }
}

7.3 智能亮度调节

根据环境光自动调整亮度：

c复制void OLED_Auto_Brightness(void)
{
    uint16_t light = ADC_Read(ALS_SENSOR);
    uint8_t contrast = light / 16; // 0-255
    OLED_WR_Byte(0x81, OLED_CMD);  // 设置对比度
    OLED_WR_Byte(contrast, OLED_CMD);
}

8. 工程优化建议

8.1 代码架构优化

推荐采用分层架构：

code复制/Application
  menu.c
  chart.c
/Drivers
  /OLED
    oled.c
    oled_font.c
  /SPI
    spi.c
/Hardware
  board.c
/Middlewares
  /GUI
    gui.c

8.2 版本兼容性处理

通过宏定义适配不同OLED型号：

c复制#if defined(OLED_SSD1306)
    #define OLED_WIDTH  128
    #define OLED_HEIGHT 64
    #define OLED_INIT_CMD ssd1306_init_cmd
#elif defined(OLED_SH1106)
    #define OLED_WIDTH  132
    #define OLED_HEIGHT 64
    #define OLED_INIT_CMD sh1106_init_cmd
#endif

8.3 测试用例设计

构建自动化测试框架：

c复制void OLED_Test_Suite(void)
{
    TEST_CASE("Basic Display", {
        OLED_Clear(0);
        OLED_ShowString(0, 0, "TEST", 16);
        ASSERT(Check_Screen(0, 0, "TEST"));
    });
    
    TEST_CASE("Chinese Display", {
        OLED_ShowChinese(0, 2, "测试");
        ASSERT(Check_Screen(0, 2, "测试"));
    });
}

9. 资源扩展方案

9.1 外部存储器扩展

使用SPI Flash存储大量字库：

c复制void Load_Font_From_Flash(uint32_t addr, uint8_t *buf)
{
    SPI_Flash_Read(addr, buf, 32); // 16x16汉字占32字节
    OLED_ShowCustomFont(0, 0, buf);
}

9.2 多屏协同显示

通过SPI总线挂载多个OLED：

c复制void OLED_Multi_Display(void)
{
    // 选择屏幕1
    OLED1_CS_Clr();
    OLED_ShowString(0, 0, "Screen 1");
    OLED1_CS_Set();
    
    // 选择屏幕2
    OLED2_CS_Clr();
    OLED_ShowString(0, 0, "Screen 2");
    OLED2_CS_Set();
}

9.3 图形库移植

移植u8g2图形库到STM32：

1. 实现硬件层接口：

c复制uint8_t u8x8_stm32_gpio_and_delay(...)
{
    // GPIO控制实现
}

uint8_t u8x8_byte_stm32_spi(...)
{
    // SPI传输实现
}

2. 初始化配置：

c复制U8G2_SSD1306_128X64_NONAME_1_4W_HW_SPI u8g2;
u8g2_Setup_ssd1306_128x64_noname_1(&u8g2, U8G2_R0, u8x8_byte_stm32_spi, u8x8_stm32_gpio_and_delay);

10. 项目实战案例

10.1 智能温控器界面

实现参数设置与实时监控：

c复制void TempController_UI(void)
{
    static uint8_t mode = 0;
    while(1){
        OLED_ClearBuffer();
        
        // 显示当前温度
        OLED_ShowString(0, 0, "Temp:", 16);
        OLED_ShowFloat(40, 0, read_temp(), 1, 16);
        
        // 显示设置温度
        OLED_ShowString(0, 2, "Set:", 16);
        OLED_ShowFloat(40, 2, target_temp, 1, 16);
        
        // 模式指示
        if(mode) OLED_ShowString(80, 0, "AUTO", 16);
        else OLED_ShowString(80, 0, "MANU", 16);
        
        // 控制指示
        if(heater_status) 
            OLED_ShowString(80, 2, "HEAT", 16);
        
        OLED_Refresh();
        
        // 按键处理
        if(KEY_Read() == KEY_MODE){
            mode = !mode;
        }
        Delay_ms(100);
    }
}

10.2 物联网数据看板

显示远程传感器数据：

c复制void IoT_Dashboard(void)
{
    while(1){
        MQTT_Update(); // 获取最新数据
        
        OLED_ClearBuffer();
        Draw_Gauge(10, 10, "Temperature", temp_value, 0, 50);
        Draw_Gauge(70, 10, "Humidity", humi_value, 0, 100);
        
        OLED_ShowString(0, 6, "Last Update:", 12);
        OLED_ShowTime(72, 6, rtc_time);
        
        OLED_Refresh();
        Delay_ms(5000);
    }
}

10.3 嵌入式游戏开发

实现经典贪吃蛇游戏：

c复制void Snake_Game(void)
{
    Snake snake;
    Food food;
    Init_Game(&snake, &food);
    
    while(!game_over){
        // 处理输入
        switch(KEY_Read()){
            case KEY_UP: snake.dir = UP; break;
            case KEY_DOWN: snake.dir = DOWN; break;
            // 其他方向...
        }
        
        // 更新游戏状态
        Move_Snake(&snake);
        if(Check_Collision(&snake)){
            game_over = 1;
            break;
        }
        if(Eat_Food(&snake, &food)){
            Grow_Snake(&snake);
            Generate_Food(&food, &snake);
        }
        
        // 渲染画面
        OLED_ClearBuffer();
        Draw_Snake(&snake);
        Draw_Food(&food);
        OLED_ShowNumber(100, 0, snake.length-3, 2);
        OLED_Refresh();
        
        Delay_ms(200 - (snake.length/5)*20);
    }
    
    Show_Game_Over(snake.length-3);
}