简介这份资源面向嵌入式开发者围绕STM32驱动SSD1322控制芯片的OLED显示屏提供可直接运行的C/C工程源码适合正在调试SPI或8080接口OLED、需要参考初始化流程与底层驱动的中初级开发者。压缩包共76个文件以32个h头文件、31个c源文件为主附带Keil MDK5工程文件、系统配置文件及删除工程多余文件的小脚本源文件按LCD驱动、系统延时、STM32标准库分层组织目录清晰便于移植到实际项目。资源包大小约285KB轻量紧凑可用于快速对照硬件时序、命令发送和灰度控制逻辑。目前已有1080人学习下载是验证SPI驱动OLED显示方案时值得参考的示例工程。内容涵盖SSD1322初始化、显存刷新、图形与文本绘制等关键环节并给出STM32引脚配置和通信接口的代码框架能帮助减少查手册、调时序的重复工作。1. 为什么你的 OLED 会花屏SSD1322 灰度映射与 STM32 的第一次握手一块128x64的OLED屏屏驱是SSD1322很多人按SSD1306的点屏流程去初始化结果看到的不是预期内容而是满屏雪花。原因在于SSD1322每个像素用4bit表示16级灰度SPI总线上一字节要携带两个像素的灰度同时显存窗口设置错误会导致内容整体错位。这套基于STM32F103标准外设库FWlib的驱动把初始化、显存维护和刷新过程拆开写工程用RVMDK uv5打开即可编译烧录适合正在调0.91寸到1.44寸这类SSD1322模组的开发者。2. SSD1322 的接口选型为什么要用硬件 SPI引脚和初始化代码2.1 选型依据SPI 与 8080 并口的取舍SSD1322 同时支持 8080 并行接口和 4 线 SPI 接口。8080 并口在写入 8bit 数据时由 WR、RD、RS有些屏叫 DC和 CS 的组合控制锁存理论吞吐可以做到很高适合高速刷新、动画或者双缓冲切换。但并口需要至少 8 根数据线加 4 根控制线在 STM32F103C8T6 这种小封装上会挤占大量引脚而且长排线还容易产生信号串扰。反过来看4 线 SPI 只需要 SCK、MOSI、CS、DC加上复位和电源总共 6 个连接在多数项目里是性价比最高的选择。不管你是用 0.91 寸还是 1.44 寸 OLED 显示模块SSD1322 驱动芯片的接口逻辑是一致的。这里要补充一点有些屏还支持三线 SPI即把 DC 信号编码到字节前面但工程里普遍使用四线因为 DC 独立一根线在时序上更简单调试时也容易用示波器区分命令和数据。STM32 的硬件 SPI1 可以跑到 18MHz72MHz APB 总线四分之一分频时甚至能更高实际驱动 128x64 模组时我一般控制在 4.5MHz 左右既保证刷屏速度又能容忍杜邦线的分布电容。2.2 引脚映射与接线表以 STM32F103C8T6 和 SPI1 为例推荐接线如下屏端信号STM32 引脚方向说明SCKPA5输出SPI1_SCK配置为复用推挽MOSI/SDAPA7输出SPI1_MOSI只写屏不读数据CSPA4输出普通 GPIO 软件控制DC/RSPB0输出0 发命令1 发数据RESPB1输出复位低电平复位VCC3.3V电源多数模组 3.3V少数 5V 需确认GNDGND电源共地注意与 MCU 地同电位提示不要把 CS 接到 SPI 硬件 NSSPA15更不要把 NSS 配置成硬件模式否则一旦产生 MODF 错误SPI 外设会自动释放总线屏幕会随机闪。用普通 GPIO 拉低是最稳定做法。MISOPA6不需要连接因为 SSD1322 没有向 MCU 返回数据的命令读写方向完全由 DC 线和 SPI 写操作决定。2.3 SPI 初始化与命令/数据写入的底层实现这段代码完成 GPIO、SPI1 初始化和软件复位。使用标准外设库。void OLED_GPIO_SPI_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_SPI1, ENABLE); // SCK:PA5, MOSI:PA7 复用推挽 GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_Init(GPIOA, GPIO_InitStructure); // CS:PA4, DC:PB0, RES:PB1 普通推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_0 | GPIO_Pin_1; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOB, GPIO_InitStructure); SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_16; SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }这段初始化里SPI_Direction 用了双线全双工虽然 SSD1322 不返回数据但全双工模式下 MOSI 输出波形和 FIFO 处理比半双工 1Line_TX 更稳定。SPI_CPOL_Low 和 SPI_CPHA_1Edge 对应模式 0即空闲时 SCK 为低第一个边沿采样如果屏的数据手册要求模式 1 或模式 2改这两个宏就行。分频 16 在 72MHz 主频下得到 4.5MHz实际使用中我一般先用 4.5MHz排线太长再降到 2.25MHz即把分频改成 32。#define OLED_CS_L() GPIO_ResetBits(GPIOA, GPIO_Pin_4) #define OLED_CS_H() GPIO_SetBits(GPIOA, GPIO_Pin_4) #define OLED_DC_L() GPIO_ResetBits(GPIOB, GPIO_Pin_0) #define OLED_DC_H() GPIO_SetBits(GPIOB, GPIO_Pin_0) #define OLED_RES_L() GPIO_ResetBits(GPIOB, GPIO_Pin_1) #define OLED_RES_H() GPIO_SetBits(GPIOB, GPIO_Pin_1) void OLED_WriteCmd(uint8_t cmd) { OLED_CS_L(); OLED_DC_L(); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); SPI_I2S_SendData(SPI1, cmd); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_BSY) SET); OLED_CS_H(); } void OLED_WriteData(uint8_t dat) { OLED_CS_L(); OLED_DC_H(); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); SPI_I2S_SendData(SPI1, dat); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_BSY) SET); OLED_CS_H(); } void OLED_Reset(void) { OLED_RES_H(); delay_ms(5); OLED_RES_L(); delay_ms(5); OLED_RES_H(); delay_ms(20); }发送前先等待 TXE 置位也就是发送数据寄存器空。发送后等待 BSY 清零确保字节从移位寄存器移出。CS 在每字节之间拉高是简单做法代价是每个字节多几个微秒间隔对初始化没有影响。如果后面做全屏刷新最好连续写完整帧再拉高 CS避免频繁翻转造成时序空隙。复位时序是 RES 拉高、拉低再拉高并保持足够时间很多屏对复位低电平最小时间有要求用 5ms 已经留了余量。3. SSD1322 初始化序列、显存窗口与 4bit 灰度映射3.1 命令锁与 DC 线的工作方式SSD1322 上电后默认处于命令锁定状态许多配置寄存器不可写所以初始化第一件事就是发送 0xFD 0x12 解锁即 Set Command Lock 命令。之后每个命令同样通过 MOSI 传输由 DC 线决定当前字节是命令还是数据。DC 为低时SPI 收到的字节会写入命令寄存器DC 为高时则写入对应命令的数据参数或者写入显示 RAM。如果 DC 线在初始化过程中被拉错了可能现象非常隐蔽SPI 波形完全正常但屏就是不工作或者只亮奇数/偶数列。因此底层函数必须固定为先拉低 CS再设置 DC 到对应电平然后发送字节最后拉高 CS。不要先拉 DC 再拉 CS也不要对每个命令的数据参数错误地使用低 DC。如果你的屏是 SSD1322U命令集与 SSD1322 基本一致只是部分泵电压参数需要根据屏厂方案微调。3.2 初始化命令序列与参数说明一个典型的 128x64 SSD1322 初始化序列如下参数基于常见 3.3V 模组不同屏厂会有微调。void SSD1322_Init(void) { OLED_Reset(); OLED_WriteCmd(0xFD); OLED_WriteData(0x12); // 解锁命令锁 OLED_WriteCmd(0xA8); OLED_WriteData(0x3F); // MUX64行 OLED_WriteCmd(0xA1); OLED_WriteData(0x00); // 显示起始行0 OLED_WriteCmd(0xA2); OLED_WriteData(0x00); // 显示偏移0 OLED_WriteCmd(0xA4); // 显示内容来自RAM OLED_WriteCmd(0xA6); // 非反色 OLED_WriteCmd(0x81); OLED_WriteData(0x7F); // 对比度127 OLED_WriteCmd(0xB3); OLED_WriteData(0x01); // 时钟分频 OLED_WriteCmd(0x90); OLED_WriteData(0x01); // Phase长度 OLED_WriteCmd(0xBC); OLED_WriteData(0x08); // 预充电压 OLED_WriteCmd(0xBE); OLED_WriteData(0x07); // VCOMH电压 OLED_WriteCmd(0x15); OLED_WriteData(0x00); OLED_WriteData(0x3F); // 列地址0~63 OLED_WriteCmd(0x75); OLED_WriteData(0x00); OLED_WriteData(0x3F); // 行地址0~63 OLED_WriteCmd(0xAF); // 打开显示 }逐条解释一下0xFD 0x12 是解锁0xA8 后面的 0x3F 表示 64 路 MUX对应 64 行扫描0xA1 和 0xA2 让显示从第 0 行开始且不加偏移避免图像上下偏移0xA4 表示显示缓冲区的数据参与显示如果发 0xA5 则强制全屏点亮常用于硬件测试0xA6 是正常颜色0xA7 会把灰阶反转。0x81 对比度默认 127室内屏一般够用阳光下可以调到 0xFF但功耗会增加。0xB3、0x90、0xBC、0xBE 这四个影响 OSC 分频、相位和泵电路电压如果刷新率过高出现闪烁通常优先调 0xB3 和 0x90。最后两行设定了访问窗口0x15 后面的两个参数是列地址范围0x75 后面的两个是行地址范围。对 128x64 模组列地址范围写成 0x00 到 0x3F原因见下一节。如果用的是 128x32 模组MUX 设为 0x1F行范围改为 0x00-0x1F列范围仍然是 0x00-0x3F宽度 128 不变。命令速查如下命令参数作用0xFD0x12解锁0xA80x3FMUX 640x810x7F对比度0x150x00 0x3F列范围0x750x00 0x3F行范围0xAF无显示开3.3 为什么列地址是 0x00-0x3F4bit 打包的显存格式SSD1322 一个像素只有 4bit即 16 级灰度为了充分利用内存芯片把每两个像素打包进一个字节高 4bit 放在偶数列低 4bit 放在奇数列。换句话说128 个像素列对应 64 个数据字节列地址寄存器里的 0 到 63 指的就是这 64 个字节的位置而不是像素列号。这也是初学者最容易懵的地方明明屏幕宽度是 128为什么列地址写到 63 就结束了。数据传输的偏移也同理刷新窗口要从行地址 0 和列地址 0 开始然后按行优先顺序连续发送 64 个字节完成一行再自动切到下一行。如果在发送一行的第 40 字节时插入了其他命令行地址可能没有变化下一帧数据就会错位。所以写显存时要么坚持一次性发完整帧要么严格按窗口地址回卷。用 0xA5 全屏点亮测试后可以发 0xA4 恢复再发单色数据验证灰度。0xA5 强制所有像素为最亮灰度不依赖 RAM 内容是判断屏和驱动板是否基本完好的第一级测试。低功耗场景下0xAE 是关屏进入预充电模式空闲时可以发 0xAE需要显示时再发 0xAF不需要重新初始化但需要重新设置窗口。4. 显存缓冲、字符绘制与 HAL 库移植4.1 帧缓冲该开多大128x64x4bit 的实际内存占用每个像素 4bit128 像素宽就是 64 字节每行64 行一共 4096 字节。在 STM32F103C8T6 中SRAM 为 20KB4KB 显存占了 20%。如果显示内容只有文字和简单图形可以不用帧缓冲直接边算边发但一旦要做图形叠加、清屏、多窗口局部刷新没有帧缓冲的代码会非常痛苦。我一般会这样定义uint8_t g_oled_framebuffer[64][64]; // [行][列字节]用 64 行 x 64 列字节正好覆盖 128x64 4bit。注意不要在函数内部定义这个数组4KB 的局部变量会直接撑爆栈必须声明成全局或静态变量。如果换用 128x32 的屏数组变成 32x64即 2KB。4.2 画点、填充和字符绘制先写画点。参数 x、y 是像素坐标gray 是 0~15 灰度值。需要根据 x 的奇偶确定在字节中的位置void OLED_DrawPixel(uint8_t x, uint8_t y, uint8_t gray) { if (x 128 || y 64) return; uint8_t bytePos x / 2; uint8_t shift (x % 2) ? 0 : 4; // 偶数列高4bit g_oled_framebuffer[y][bytePos] ~(0x0F shift); g_oled_framebuffer[y][bytePos] | (gray 0x0F) shift; }逻辑说明x/2算字节下标x%2为 0 时是偶数列放在高 4bit为 1 时放低 4bit。先清掉对应位置原来的 4bit再写入新灰度避免破坏相邻像素。这里的shift只有 0 和 4 两个取值刚好把 nibble 挡在正确位置上。填充全屏时把每个字节的两个像素同时写成目标灰度void OLED_Fill(uint8_t gray) { uint8_t byteVal (gray 0x0F) 4 | (gray 0x0F); for (uint16_t i 0; i 64 * 64; i) { ((uint8_t *)g_oled_framebuffer)[i] byteVal; } }然后是全帧发送函数void OLED_Refresh(void) { OLED_WriteCmd(0x15); OLED_WriteData(0x00); OLED_WriteData(0x3F); OLED_WriteCmd(0x75); OLED_WriteData(0x00); OLED_WriteData(0x3F); OLED_CS_L(); OLED_DC_H(); for (uint16_t i 0; i 64 * 64; i) { while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); SPI_I2S_SendData(SPI1, ((uint8_t *)g_oled_framebuffer)[i]); } while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_BSY) SET); OLED_CS_H(); }注意发送时 CS 只拉低一次DC 拉高然后连续送 4096 个字节。这样既利用了列地址自动递增又避免了每字节翻转 CS 带来的总线间隙。如果中间出现其他功能中断打断刷新可以在刷新前关闭高优先级中断或者用 DMA 在后台发送。标准库下用SPI_I2S_DMACmd配合 DMA 指向帧缓冲能把 CPU 占用率降到最低。字符绘制可以按 5x7 字模做。字模里 1 表示点亮0 表示熄灭每个点亮像素写入 0x0F熄灭像素写入 0x00。这样即使字模是单色数据也能以最高灰度上屏。如果要做反白直接把灰阶取反为15 - gray即可。4.3 从标准库工程移植到 HAL 库的要点很多拿到工程的人会用 CubeMX 重新生成 HAL 工程然后试图把OLED_WriteCmd直接搬进去。HAL 库和标准库最大的区别是 SPI 收发有了超时机制和句柄底层函数对应如下功能标准库本工程HAL 库发送一个字节SPI_I2S_SendDataHAL_SPI_Transmit(hspi1, byte, 1, timeout)等待发送完成TXE/BSY循环HAL 函数内部处理控制 CS/DCGPIO 宏HAL_GPIO_WritePin延时delay_msHAL_Delay移植时把下面这段替换掉底层发送部分即可void OLED_WriteDataHAL(uint8_t dat) { OLED_CS_L(); OLED_DC_H(); HAL_SPI_Transmit(hspi1, dat, 1, 1000); OLED_CS_H(); }需要注意的是HAL_SPI_Transmit多了一个超时时间并且如果 SPI 没有启用 DMA函数内部会一直等待 BSY 标志。超时参数不要写太小否则系统繁忙时会误报超时。如果刷新频率要求高建议把帧缓冲发送部分改成 DMA并确保hspi1的初始化参数与标准库一致模式 0、MSB 优先、8bit 数据、主模式。只要保持这里一致前面画点和字模代码可以原封不动地复用。江协科技那类 HAL 工程里常见的做法也是把驱动拆成底层 SPI 函数和上层显示逻辑方便换屏时只改一行底层代码。5. 从花屏到稳定显示的三个排障切入点5.1 先做 0xA5 全屏点亮拿到屏先不要跑显示代码直接发复位和 0xFD 0x12再发 0xA5看是否整屏均匀点亮。这一步同时验证了 SPI 通路、电源、复位和 DC 线。0xA5 是强迫显示 RAM 全高不依赖初始化窗口如果这样还不亮重点查接线和供电如果亮了后面初始化问题基本都在窗口和 DC 时序。5.2 用 0x88 单灰阶验证 4bit 打包全屏点亮后发 0xA4 回到 RAM 显示然后把窗口设为 0x00-0x3F 和 0x00-0x3F连续发送 4096 个字节 0x88。0x88 的二进制是 10001000即高 4bit 是 8低 4bit 也等于 8这样两个像素都是灰度 8屏幕应该显示均匀的中灰色。如果出现左半亮右半暗说明字节里两个 nibble 的顺序反了如果出现一行亮一行暗说明列地址范围或发送顺序有问题。5.3 检查 CS 和 DC 的时序余量最后一个常见坑是 CS 拉低的同时切换 DC但 SSD1322 的 D/C 数据建立时间要求是微秒级实际上如果 SPI 时钟在 4.5MHz一个 bit 约 222ns大多数屏对 DC 建立时间的容忍度都够。问题往往出在标准库代码中先写 GPIO 寄存器再发送 SPI 字节的顺序上。做法是先设置 DC再拉低 CS再发字节即OLED_DC_L(); OLED_CS_L(); SPI_I2S_SendData(SPI1, cmd);如果这里调换来写某些屏会出现高频花点。用示波器探 DC 和 SCK 可以立刻发现没有示波器的可以用逻辑分析仪连续抓一段 0x15 命令后的字节流数一数 DC 电平变化是否与数据同步。如果批量刷新时屏幕底部出现残影把每帧之间的延时固定到 20ms并避免在发送过程中用delay_ms长延时因为这会拉长列地址自动递增的间隔OLED 的驱动电容电荷会漏掉一部分造成亮暗不均。本文还有配套的精品资源点击获取 STM32驱动SSD1322 OLED屏：SPI接口与4bit灰度映射详解
简介这份资源面向嵌入式开发者围绕STM32驱动SSD1322控制芯片的OLED显示屏提供可直接运行的C/C工程源码适合正在调试SPI或8080接口OLED、需要参考初始化流程与底层驱动的中初级开发者。压缩包共76个文件以32个h头文件、31个c源文件为主附带Keil MDK5工程文件、系统配置文件及删除工程多余文件的小脚本源文件按LCD驱动、系统延时、STM32标准库分层组织目录清晰便于移植到实际项目。资源包大小约285KB轻量紧凑可用于快速对照硬件时序、命令发送和灰度控制逻辑。目前已有1080人学习下载是验证SPI驱动OLED显示方案时值得参考的示例工程。内容涵盖SSD1322初始化、显存刷新、图形与文本绘制等关键环节并给出STM32引脚配置和通信接口的代码框架能帮助减少查手册、调时序的重复工作。1. 为什么你的 OLED 会花屏SSD1322 灰度映射与 STM32 的第一次握手一块128x64的OLED屏屏驱是SSD1322很多人按SSD1306的点屏流程去初始化结果看到的不是预期内容而是满屏雪花。原因在于SSD1322每个像素用4bit表示16级灰度SPI总线上一字节要携带两个像素的灰度同时显存窗口设置错误会导致内容整体错位。这套基于STM32F103标准外设库FWlib的驱动把初始化、显存维护和刷新过程拆开写工程用RVMDK uv5打开即可编译烧录适合正在调0.91寸到1.44寸这类SSD1322模组的开发者。2. SSD1322 的接口选型为什么要用硬件 SPI引脚和初始化代码2.1 选型依据SPI 与 8080 并口的取舍SSD1322 同时支持 8080 并行接口和 4 线 SPI 接口。8080 并口在写入 8bit 数据时由 WR、RD、RS有些屏叫 DC和 CS 的组合控制锁存理论吞吐可以做到很高适合高速刷新、动画或者双缓冲切换。但并口需要至少 8 根数据线加 4 根控制线在 STM32F103C8T6 这种小封装上会挤占大量引脚而且长排线还容易产生信号串扰。反过来看4 线 SPI 只需要 SCK、MOSI、CS、DC加上复位和电源总共 6 个连接在多数项目里是性价比最高的选择。不管你是用 0.91 寸还是 1.44 寸 OLED 显示模块SSD1322 驱动芯片的接口逻辑是一致的。这里要补充一点有些屏还支持三线 SPI即把 DC 信号编码到字节前面但工程里普遍使用四线因为 DC 独立一根线在时序上更简单调试时也容易用示波器区分命令和数据。STM32 的硬件 SPI1 可以跑到 18MHz72MHz APB 总线四分之一分频时甚至能更高实际驱动 128x64 模组时我一般控制在 4.5MHz 左右既保证刷屏速度又能容忍杜邦线的分布电容。2.2 引脚映射与接线表以 STM32F103C8T6 和 SPI1 为例推荐接线如下屏端信号STM32 引脚方向说明SCKPA5输出SPI1_SCK配置为复用推挽MOSI/SDAPA7输出SPI1_MOSI只写屏不读数据CSPA4输出普通 GPIO 软件控制DC/RSPB0输出0 发命令1 发数据RESPB1输出复位低电平复位VCC3.3V电源多数模组 3.3V少数 5V 需确认GNDGND电源共地注意与 MCU 地同电位提示不要把 CS 接到 SPI 硬件 NSSPA15更不要把 NSS 配置成硬件模式否则一旦产生 MODF 错误SPI 外设会自动释放总线屏幕会随机闪。用普通 GPIO 拉低是最稳定做法。MISOPA6不需要连接因为 SSD1322 没有向 MCU 返回数据的命令读写方向完全由 DC 线和 SPI 写操作决定。2.3 SPI 初始化与命令/数据写入的底层实现这段代码完成 GPIO、SPI1 初始化和软件复位。使用标准外设库。void OLED_GPIO_SPI_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_SPI1, ENABLE); // SCK:PA5, MOSI:PA7 复用推挽 GPIO_InitStructure.GPIO_Pin GPIO_Pin_5 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_Init(GPIOA, GPIO_InitStructure); // CS:PA4, DC:PB0, RES:PB1 普通推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_4; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_0 | GPIO_Pin_1; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(GPIOB, GPIO_InitStructure); SPI_InitStructure.SPI_Direction SPI_Direction_2Lines_FullDuplex; SPI_InitStructure.SPI_Mode SPI_Mode_Master; SPI_InitStructure.SPI_DataSize SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL SPI_CPOL_Low; SPI_InitStructure.SPI_CPHA SPI_CPHA_1Edge; SPI_InitStructure.SPI_NSS SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler SPI_BaudRatePrescaler_16; SPI_InitStructure.SPI_FirstBit SPI_FirstBit_MSB; SPI_Init(SPI1, SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }这段初始化里SPI_Direction 用了双线全双工虽然 SSD1322 不返回数据但全双工模式下 MOSI 输出波形和 FIFO 处理比半双工 1Line_TX 更稳定。SPI_CPOL_Low 和 SPI_CPHA_1Edge 对应模式 0即空闲时 SCK 为低第一个边沿采样如果屏的数据手册要求模式 1 或模式 2改这两个宏就行。分频 16 在 72MHz 主频下得到 4.5MHz实际使用中我一般先用 4.5MHz排线太长再降到 2.25MHz即把分频改成 32。#define OLED_CS_L() GPIO_ResetBits(GPIOA, GPIO_Pin_4) #define OLED_CS_H() GPIO_SetBits(GPIOA, GPIO_Pin_4) #define OLED_DC_L() GPIO_ResetBits(GPIOB, GPIO_Pin_0) #define OLED_DC_H() GPIO_SetBits(GPIOB, GPIO_Pin_0) #define OLED_RES_L() GPIO_ResetBits(GPIOB, GPIO_Pin_1) #define OLED_RES_H() GPIO_SetBits(GPIOB, GPIO_Pin_1) void OLED_WriteCmd(uint8_t cmd) { OLED_CS_L(); OLED_DC_L(); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); SPI_I2S_SendData(SPI1, cmd); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_BSY) SET); OLED_CS_H(); } void OLED_WriteData(uint8_t dat) { OLED_CS_L(); OLED_DC_H(); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); SPI_I2S_SendData(SPI1, dat); while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_BSY) SET); OLED_CS_H(); } void OLED_Reset(void) { OLED_RES_H(); delay_ms(5); OLED_RES_L(); delay_ms(5); OLED_RES_H(); delay_ms(20); }发送前先等待 TXE 置位也就是发送数据寄存器空。发送后等待 BSY 清零确保字节从移位寄存器移出。CS 在每字节之间拉高是简单做法代价是每个字节多几个微秒间隔对初始化没有影响。如果后面做全屏刷新最好连续写完整帧再拉高 CS避免频繁翻转造成时序空隙。复位时序是 RES 拉高、拉低再拉高并保持足够时间很多屏对复位低电平最小时间有要求用 5ms 已经留了余量。3. SSD1322 初始化序列、显存窗口与 4bit 灰度映射3.1 命令锁与 DC 线的工作方式SSD1322 上电后默认处于命令锁定状态许多配置寄存器不可写所以初始化第一件事就是发送 0xFD 0x12 解锁即 Set Command Lock 命令。之后每个命令同样通过 MOSI 传输由 DC 线决定当前字节是命令还是数据。DC 为低时SPI 收到的字节会写入命令寄存器DC 为高时则写入对应命令的数据参数或者写入显示 RAM。如果 DC 线在初始化过程中被拉错了可能现象非常隐蔽SPI 波形完全正常但屏就是不工作或者只亮奇数/偶数列。因此底层函数必须固定为先拉低 CS再设置 DC 到对应电平然后发送字节最后拉高 CS。不要先拉 DC 再拉 CS也不要对每个命令的数据参数错误地使用低 DC。如果你的屏是 SSD1322U命令集与 SSD1322 基本一致只是部分泵电压参数需要根据屏厂方案微调。3.2 初始化命令序列与参数说明一个典型的 128x64 SSD1322 初始化序列如下参数基于常见 3.3V 模组不同屏厂会有微调。void SSD1322_Init(void) { OLED_Reset(); OLED_WriteCmd(0xFD); OLED_WriteData(0x12); // 解锁命令锁 OLED_WriteCmd(0xA8); OLED_WriteData(0x3F); // MUX64行 OLED_WriteCmd(0xA1); OLED_WriteData(0x00); // 显示起始行0 OLED_WriteCmd(0xA2); OLED_WriteData(0x00); // 显示偏移0 OLED_WriteCmd(0xA4); // 显示内容来自RAM OLED_WriteCmd(0xA6); // 非反色 OLED_WriteCmd(0x81); OLED_WriteData(0x7F); // 对比度127 OLED_WriteCmd(0xB3); OLED_WriteData(0x01); // 时钟分频 OLED_WriteCmd(0x90); OLED_WriteData(0x01); // Phase长度 OLED_WriteCmd(0xBC); OLED_WriteData(0x08); // 预充电压 OLED_WriteCmd(0xBE); OLED_WriteData(0x07); // VCOMH电压 OLED_WriteCmd(0x15); OLED_WriteData(0x00); OLED_WriteData(0x3F); // 列地址0~63 OLED_WriteCmd(0x75); OLED_WriteData(0x00); OLED_WriteData(0x3F); // 行地址0~63 OLED_WriteCmd(0xAF); // 打开显示 }逐条解释一下0xFD 0x12 是解锁0xA8 后面的 0x3F 表示 64 路 MUX对应 64 行扫描0xA1 和 0xA2 让显示从第 0 行开始且不加偏移避免图像上下偏移0xA4 表示显示缓冲区的数据参与显示如果发 0xA5 则强制全屏点亮常用于硬件测试0xA6 是正常颜色0xA7 会把灰阶反转。0x81 对比度默认 127室内屏一般够用阳光下可以调到 0xFF但功耗会增加。0xB3、0x90、0xBC、0xBE 这四个影响 OSC 分频、相位和泵电路电压如果刷新率过高出现闪烁通常优先调 0xB3 和 0x90。最后两行设定了访问窗口0x15 后面的两个参数是列地址范围0x75 后面的两个是行地址范围。对 128x64 模组列地址范围写成 0x00 到 0x3F原因见下一节。如果用的是 128x32 模组MUX 设为 0x1F行范围改为 0x00-0x1F列范围仍然是 0x00-0x3F宽度 128 不变。命令速查如下命令参数作用0xFD0x12解锁0xA80x3FMUX 640x810x7F对比度0x150x00 0x3F列范围0x750x00 0x3F行范围0xAF无显示开3.3 为什么列地址是 0x00-0x3F4bit 打包的显存格式SSD1322 一个像素只有 4bit即 16 级灰度为了充分利用内存芯片把每两个像素打包进一个字节高 4bit 放在偶数列低 4bit 放在奇数列。换句话说128 个像素列对应 64 个数据字节列地址寄存器里的 0 到 63 指的就是这 64 个字节的位置而不是像素列号。这也是初学者最容易懵的地方明明屏幕宽度是 128为什么列地址写到 63 就结束了。数据传输的偏移也同理刷新窗口要从行地址 0 和列地址 0 开始然后按行优先顺序连续发送 64 个字节完成一行再自动切到下一行。如果在发送一行的第 40 字节时插入了其他命令行地址可能没有变化下一帧数据就会错位。所以写显存时要么坚持一次性发完整帧要么严格按窗口地址回卷。用 0xA5 全屏点亮测试后可以发 0xA4 恢复再发单色数据验证灰度。0xA5 强制所有像素为最亮灰度不依赖 RAM 内容是判断屏和驱动板是否基本完好的第一级测试。低功耗场景下0xAE 是关屏进入预充电模式空闲时可以发 0xAE需要显示时再发 0xAF不需要重新初始化但需要重新设置窗口。4. 显存缓冲、字符绘制与 HAL 库移植4.1 帧缓冲该开多大128x64x4bit 的实际内存占用每个像素 4bit128 像素宽就是 64 字节每行64 行一共 4096 字节。在 STM32F103C8T6 中SRAM 为 20KB4KB 显存占了 20%。如果显示内容只有文字和简单图形可以不用帧缓冲直接边算边发但一旦要做图形叠加、清屏、多窗口局部刷新没有帧缓冲的代码会非常痛苦。我一般会这样定义uint8_t g_oled_framebuffer[64][64]; // [行][列字节]用 64 行 x 64 列字节正好覆盖 128x64 4bit。注意不要在函数内部定义这个数组4KB 的局部变量会直接撑爆栈必须声明成全局或静态变量。如果换用 128x32 的屏数组变成 32x64即 2KB。4.2 画点、填充和字符绘制先写画点。参数 x、y 是像素坐标gray 是 0~15 灰度值。需要根据 x 的奇偶确定在字节中的位置void OLED_DrawPixel(uint8_t x, uint8_t y, uint8_t gray) { if (x 128 || y 64) return; uint8_t bytePos x / 2; uint8_t shift (x % 2) ? 0 : 4; // 偶数列高4bit g_oled_framebuffer[y][bytePos] ~(0x0F shift); g_oled_framebuffer[y][bytePos] | (gray 0x0F) shift; }逻辑说明x/2算字节下标x%2为 0 时是偶数列放在高 4bit为 1 时放低 4bit。先清掉对应位置原来的 4bit再写入新灰度避免破坏相邻像素。这里的shift只有 0 和 4 两个取值刚好把 nibble 挡在正确位置上。填充全屏时把每个字节的两个像素同时写成目标灰度void OLED_Fill(uint8_t gray) { uint8_t byteVal (gray 0x0F) 4 | (gray 0x0F); for (uint16_t i 0; i 64 * 64; i) { ((uint8_t *)g_oled_framebuffer)[i] byteVal; } }然后是全帧发送函数void OLED_Refresh(void) { OLED_WriteCmd(0x15); OLED_WriteData(0x00); OLED_WriteData(0x3F); OLED_WriteCmd(0x75); OLED_WriteData(0x00); OLED_WriteData(0x3F); OLED_CS_L(); OLED_DC_H(); for (uint16_t i 0; i 64 * 64; i) { while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_TXE) RESET); SPI_I2S_SendData(SPI1, ((uint8_t *)g_oled_framebuffer)[i]); } while (SPI_I2S_GetFlagStatus(SPI1, SPI_I2S_FLAG_BSY) SET); OLED_CS_H(); }注意发送时 CS 只拉低一次DC 拉高然后连续送 4096 个字节。这样既利用了列地址自动递增又避免了每字节翻转 CS 带来的总线间隙。如果中间出现其他功能中断打断刷新可以在刷新前关闭高优先级中断或者用 DMA 在后台发送。标准库下用SPI_I2S_DMACmd配合 DMA 指向帧缓冲能把 CPU 占用率降到最低。字符绘制可以按 5x7 字模做。字模里 1 表示点亮0 表示熄灭每个点亮像素写入 0x0F熄灭像素写入 0x00。这样即使字模是单色数据也能以最高灰度上屏。如果要做反白直接把灰阶取反为15 - gray即可。4.3 从标准库工程移植到 HAL 库的要点很多拿到工程的人会用 CubeMX 重新生成 HAL 工程然后试图把OLED_WriteCmd直接搬进去。HAL 库和标准库最大的区别是 SPI 收发有了超时机制和句柄底层函数对应如下功能标准库本工程HAL 库发送一个字节SPI_I2S_SendDataHAL_SPI_Transmit(hspi1, byte, 1, timeout)等待发送完成TXE/BSY循环HAL 函数内部处理控制 CS/DCGPIO 宏HAL_GPIO_WritePin延时delay_msHAL_Delay移植时把下面这段替换掉底层发送部分即可void OLED_WriteDataHAL(uint8_t dat) { OLED_CS_L(); OLED_DC_H(); HAL_SPI_Transmit(hspi1, dat, 1, 1000); OLED_CS_H(); }需要注意的是HAL_SPI_Transmit多了一个超时时间并且如果 SPI 没有启用 DMA函数内部会一直等待 BSY 标志。超时参数不要写太小否则系统繁忙时会误报超时。如果刷新频率要求高建议把帧缓冲发送部分改成 DMA并确保hspi1的初始化参数与标准库一致模式 0、MSB 优先、8bit 数据、主模式。只要保持这里一致前面画点和字模代码可以原封不动地复用。江协科技那类 HAL 工程里常见的做法也是把驱动拆成底层 SPI 函数和上层显示逻辑方便换屏时只改一行底层代码。5. 从花屏到稳定显示的三个排障切入点5.1 先做 0xA5 全屏点亮拿到屏先不要跑显示代码直接发复位和 0xFD 0x12再发 0xA5看是否整屏均匀点亮。这一步同时验证了 SPI 通路、电源、复位和 DC 线。0xA5 是强迫显示 RAM 全高不依赖初始化窗口如果这样还不亮重点查接线和供电如果亮了后面初始化问题基本都在窗口和 DC 时序。5.2 用 0x88 单灰阶验证 4bit 打包全屏点亮后发 0xA4 回到 RAM 显示然后把窗口设为 0x00-0x3F 和 0x00-0x3F连续发送 4096 个字节 0x88。0x88 的二进制是 10001000即高 4bit 是 8低 4bit 也等于 8这样两个像素都是灰度 8屏幕应该显示均匀的中灰色。如果出现左半亮右半暗说明字节里两个 nibble 的顺序反了如果出现一行亮一行暗说明列地址范围或发送顺序有问题。5.3 检查 CS 和 DC 的时序余量最后一个常见坑是 CS 拉低的同时切换 DC但 SSD1322 的 D/C 数据建立时间要求是微秒级实际上如果 SPI 时钟在 4.5MHz一个 bit 约 222ns大多数屏对 DC 建立时间的容忍度都够。问题往往出在标准库代码中先写 GPIO 寄存器再发送 SPI 字节的顺序上。做法是先设置 DC再拉低 CS再发字节即OLED_DC_L(); OLED_CS_L(); SPI_I2S_SendData(SPI1, cmd);如果这里调换来写某些屏会出现高频花点。用示波器探 DC 和 SCK 可以立刻发现没有示波器的可以用逻辑分析仪连续抓一段 0x15 命令后的字节流数一数 DC 电平变化是否与数据同步。如果批量刷新时屏幕底部出现残影把每帧之间的延时固定到 20ms并避免在发送过程中用delay_ms长延时因为这会拉长列地址自动递增的间隔OLED 的驱动电容电荷会漏掉一部分造成亮暗不均。本文还有配套的精品资源点击获取