STM32驱动SSD1331 OLED动画闪烁及双缓冲颜色失真问题求助

DevOps 小满

2026-6-15

解决SSD1331 OLED双缓冲动画闪烁与显示异常问题

刚接触STM32和C语言搞SSD1331动画碰到这些问题很常见，下面直接给你干货解决方案：

一、双缓冲的正确实现步骤

SSD1331是96×64的16位色（RGB565）屏，双缓冲就是在SRAM里开一块和屏幕像素完全对应的内存，所有绘图先在这块内存里完成，再一次性推给屏幕，从根源解决逐点刷新的闪烁。

1. 定义正确大小的帧缓冲
每个像素占2字节，所以缓冲大小是96*64*2字节，用静态数组存在全局区（别放栈里，栈空间不够会溢出）：
```
static uint16_t ssd1331_frame_buf[96 * 64]; // 96*64个16位像素存储单元
```

2. 把所有绘图函数改成操作缓冲
原来直接写屏幕的draw_pixel、draw_line这些函数，全部改成往ssd1331_frame_buf里写数据，比如：

void ssd1331_draw_pixel(uint8_t x, uint8_t y, uint16_t color) {
    if(x >= 96 || y >= 64) return; // 防止越界写入内存
    ssd1331_frame_buf[y * 96 + x] = color; // 按行优先顺序写入
}

3. 实现全屏刷新函数
先给SSD1331设置全屏显示窗口，再连续把整个缓冲的数据发过去，注意字节顺序（SSD1331要求高字节先传输）：

void ssd1331_refresh_screen(void) {
    // 设置全屏列范围（0~95）
    ssd1331_send_cmd(SSD1331_CMD_SET_COLUMN);
    ssd1331_send_data(0);
    ssd1331_send_data(95);
    // 设置全屏行范围（0~63）
    ssd1331_send_cmd(SSD1331_CMD_SET_ROW);
    ssd1331_send_data(0);
    ssd1331_send_data(63);
    // 开始写入显存
    ssd1331_send_cmd(SSD1331_CMD_WRITE_RAM);
    for(uint32_t i = 0; i < 96*64; i++) {
        // 先传高字节（R5+G6的高2位），再传低字节（G6低4位+B5）
        ssd1331_send_data((ssd1331_frame_buf[i] >> 8) & 0xFF);
        ssd1331_send_data(ssd1331_frame_buf[i] & 0xFF);
    }
}

二、双缓冲后颜色异常、失真的排查与解决

你碰到的颜色混乱、屏幕失真，基本是这几个坑：

1. RGB565字节顺序搞反了
SSD1331默认要求像素数据高字节在前，低字节在后。比如标准RGB565红色是0xF800，如果你把低字节先传，就会变成蓝色（0x001F），颜色直接乱套。
解决：检查颜色宏定义和发送顺序，确保和SSD1331要求一致，比如：
```
#define COLOR_RED    0xF800
#define COLOR_GREEN  0x07E0
#define COLOR_BLUE   0x001F
```
发送时严格遵循先高字节后低字节的顺序，就是上面刷新函数里的写法。

2. 缓冲清屏不彻底
每次绘制新帧前，必须把整个缓冲清成背景色（比如黑色0x0000），不然上一帧的残留像素会留在缓冲里，刷新后就会出现诡异的重叠失真。加个清缓冲函数：

void ssd1331_clear_buf(uint16_t bg_color) {
    // 直接填充整个16位数组，效率最高
    for(uint32_t i = 0; i < 96*64; i++) {
        ssd1331_frame_buf[i] = bg_color;
    }
}

动画循环里必须先清缓冲再画帧：

while(1) {
    ssd1331_clear_buf(0x0000); // 先清屏
    ssd1331_draw_animation();  // 在缓冲里绘制当前帧
    ssd1331_refresh_screen();  // 推送到屏幕
    HAL_Delay(30);             // 控制帧率，避免过快或过慢
}

3. SPI/IIC传输时序问题
如果用SPI驱动，时钟速度太高可能导致数据丢包，比如STM32的SPI设到18MHz以上，SSD1331可能跟不上。把SPI时钟降到9MHz试试，同时检查CS、DC引脚的电平切换时序，确保符合SSD1331 datasheet的要求。

三、无双缓冲时的残留像素解决

如果暂时用回单缓冲，要解决残留像素，每次绘制新帧前必须全屏清屏，不能只覆盖动的区域。比如写个全屏清屏函数：

void ssd1331_clear_full_screen(uint16_t bg_color) {
    ssd1331_send_cmd(SSD1331_CMD_SET_COLUMN);
    ssd1331_send_data(0);
    ssd1331_send_data(95);
    ssd1331_send_cmd(SSD1331_CMD_SET_ROW);
    ssd1331_send_data(0);
    ssd1331_send_data(63);
    ssd1331_send_cmd(SSD1331_CMD_WRITE_RAM);
    for(uint32_t i=0; i<96*64; i++) {
        ssd1331_send_data((bg_color >>8)&0xFF);
        ssd1331_send_data(bg_color&0xFF);
    }
}

动画循环里先清屏再绘制，虽然还是会有轻微闪烁，但至少不会有残留像素。

四、动画函数的优化建议

所有绘图操作必须统一操作缓冲，别混合直接写屏幕和写缓冲的代码，不然肯定出问题。

如果是帧序列动画，把每帧的位图转成RGB565格式，直接复制到缓冲对应位置，比逐点绘制效率高很多：

void ssd1331_draw_frame(uint8_t x, uint8_t y, uint8_t w, uint8_t h, const uint16_t* frame) {
    for(uint8_t dy=0; dy<h; dy++) {
        memcpy(&ssd1331_frame_buf[(y+dy)*96 + x], &frame[dy*w], w*2);
    }
}

内容的提问来源于stack exchange，提问作者tospros99

STM32驱动SSD1331 OLED动画闪烁及双缓冲颜色失真问题求助

一、双缓冲的正确实现步骤 #

二、双缓冲后颜色异常、失真的排查与解决 #

三、无双缓冲时的残留像素解决 #

四、动画函数的优化建议 #

一、双缓冲的正确实现步骤

二、双缓冲后颜色异常、失真的排查与解决

三、无双缓冲时的残留像素解决

四、动画函数的优化建议