CW32开发板驱动OLED屏幕的SPI通信实现

1. CW32饭盒派开发板与OLED屏幕初探

第一次拿到CW32饭盒派开发板时，我就被它小巧的尺寸和丰富的接口吸引了。这块开发板搭载了武汉芯源半导体的CW32F030C8T6芯片，基于ARM Cortex-M0内核，主频48MHz，64KB Flash和8KB RAM的配置对于嵌入式开发来说相当够用。板载的Type-C接口、用户按键和LED指示灯都让开发变得非常便捷。

这次我选择驱动的是0.96寸OLED屏幕，型号为SSD1306。这种屏幕在嵌入式领域非常流行，主要原因有三：首先是功耗极低，特别适合电池供电设备；其次是高对比度，即使在强光下也能清晰显示；最后是接口简单，支持SPI和I2C两种通信方式。我手头这块是7Pin SPI接口版本，分辨率为128x64，单色显示。

提示：购买OLED屏幕时要注意区分SPI和I2C版本，两者接线方式完全不同。SPI版本通常有7个引脚（包括电源），而I2C版本只有4个引脚。

2. 硬件连接与SPI协议基础

2.1 引脚定义与接线

在开始编程前，首先要确保硬件连接正确。我的OLED屏幕引脚定义如下：

• VCC：3.3V电源
• GND：地线
• D0(SCK)：SPI时钟线
• D1(MOSI)：SPI数据线
• RES：复位信号
• DC：数据/命令选择
• CS：片选信号

CW32饭盒派的SPI1接口引脚对应关系：

• PA5 - SPI1_SCK
• PA7 - SPI1_MOSI
• PA4 - SPI1_NSS(CS)

其他控制引脚可以自由分配，我选择了以下配置：

• PB0 - RES
• PB1 - DC
• PB2 - CS（虽然SPI1_NSS也可用，但软件控制更灵活）

接线时要注意电平匹配。CW32开发板IO口电压是3.3V，而大多数OLED屏幕也能兼容3.3V逻辑电平，所以直接连接即可。如果使用5V屏幕，需要加电平转换电路。

2.2 SPI通信协议详解

SPI(Serial Peripheral Interface)是一种同步串行通信协议，主要特点包括：

• 全双工通信
• 主从模式
• 四线制（SCK, MOSI, MISO, SS）
• 时钟极性(CPOL)和相位(CPHA)可配置

对于SSD1306 OLED，我们只需要单向传输数据（主机到从机），所以MISO线可以不用连接。SPI模式需要设置为模式0（CPOL=0, CPHA=0）或模式3（CPOL=1, CPHA=1），具体要看屏幕规格书。

SPI时钟频率不宜过高，SSD1306最大支持10MHz，但实际使用中4MHz左右比较稳定。CW32的SPI外设可以很方便地配置这些参数。

3. 开发环境搭建与基础驱动编写

3.1 CW32开发环境配置

武汉芯源提供了完善的开发支持：

1. 下载安装Keil MDK（建议5.25以上版本）
2. 安装CW32设备支持包
3. 下载CW32标准外设库

创建新工程时，需要添加以下关键文件：

• cw32f030_rcc.c：时钟配置
• cw32f030_gpio.c：GPIO控制
• cw32f030_spi.c：SPI驱动
• system_cw32f030.c：系统初始化

在Options for Target中，记得设置正确的Flash下载算法（CW32F030xx）和调试器（如ST-Link）。

3.2 SSD1306驱动实现

SSD1306的驱动主要分为几个部分：

3.2.1 底层硬件抽象层

首先定义硬件相关的宏和函数：

#define OLED_RES_PIN PB0 #define OLED_DC_PIN PB1 #define OLED_CS_PIN PB2 void OLED_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; // 初始化RES, DC, CS引脚为推挽输出 GPIO_InitStruct.Pins = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_Init(CW_GPIOB, &GPIO_InitStruct); // 默认状态 OLED_CS_HIGH(); OLED_RES_LOW(); CW_DelayMs(10); OLED_RES_HIGH(); } void SPI_WriteByte(uint8_t data) { while(RESET == SPI_GetFlagStatus(CW_SPI1, SPI_FLAG_TXE)); SPI_SendData(CW_SPI1, data); while(RESET == SPI_GetFlagStatus(CW_SPI1, SPI_FLAG_RXNE)); SPI_ReceiveData(CW_SPI1); // 清除RXNE标志 }

3.2.2 SSD1306命令与数据发送

SSD1306通过DC引脚区分命令和数据：

void OLED_WriteCmd(uint8_t cmd) { OLED_DC_LOW(); // 命令模式 OLED_CS_LOW(); SPI_WriteByte(cmd); OLED_CS_HIGH(); } void OLED_WriteData(uint8_t data) { OLED_DC_HIGH(); // 数据模式 OLED_CS_LOW(); SPI_WriteByte(data); OLED_CS_HIGH(); }

3.2.3 屏幕初始化序列

SSD1306需要按照特定顺序发送初始化命令：

void OLED_Init(void) { OLED_GPIO_Init(); // SPI初始化 SPI_InitTypeDef SPI_InitStruct; SPI_InitStruct.SPI_Direction = SPI_Direction_1Line_Tx; SPI_InitStruct.SPI_Mode = SPI_Mode_Master; SPI_InitStruct.SPI_DataSize = SPI_DataSize_8b; SPI_InitStruct.SPI_CPOL = SPI_CPOL_Low; SPI_InitStruct.SPI_CPHA = SPI_CPHA_1Edge; SPI_InitStruct.SPI_NSS = SPI_NSS_Soft; SPI_InitStruct.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_8; SPI_InitStruct.SPI_FirstBit = SPI_FirstBit_MSB; SPI_Init(CW_SPI1, &SPI_InitStruct); SPI_Cmd(CW_SPI1, ENABLE); // 发送初始化命令 OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); // 设置时钟分频 OLED_WriteCmd(0x80); OLED_WriteCmd(0xA8); // 设置复用率 OLED_WriteCmd(0x3F); // ... 更多初始化命令 OLED_WriteCmd(0xAF); // 开启显示 OLED_Clear(); }

注意：不同厂商的OLED模块可能需要微调初始化命令，如果屏幕显示异常，可以尝试调整VCOMH、预充电周期等参数。

4. 高级功能实现与优化

4.1 显示缓存管理

SSD1306内部没有显存，需要MCU维护一个显示缓存。通常定义一个128x64的数组对应屏幕像素：

uint8_t OLED_GRAM[8][128]; // 8页 x 128列 void OLED_Refresh(void) { for(uint8_t i=0; i<8; i++) { OLED_WriteCmd(0xB0 + i); // 设置页地址 OLED_WriteCmd(0x00); // 设置列地址低4位 OLED_WriteCmd(0x10); // 设置列地址高4位 for(uint8_t j=0; j<128; j++) { OLED_WriteData(OLED_GRAM[i][j]); } } }

这种全屏刷新方式简单但效率低。优化方法是只刷新变化的部分，可以设置dirty标志记录哪些区域需要更新。

4.2 基本绘图函数

基于显示缓存实现基本绘图功能：

void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t mode) { if(x >= 128 || y >= 64) return; uint8_t page = y / 8; uint8_t bit = y % 8; if(mode) { OLED_GRAM[page][x] |= (1 << bit); } else { OLED_GRAM[page][x] &= ~(1 << bit); } } void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2) { int dx = abs(x2 - x1); int dy = abs(y2 - y1); int sx = (x1 < x2) ? 1 : -1; int sy = (y1 < y2) ? 1 : -1; int err = dx - dy; while(1) { OLED_DrawPoint(x1, y1, 1); if(x1 == x2 && y1 == y2) break; int e2 = 2 * err; if(e2 > -dy) { err -= dy; x1 += sx; } if(e2 < dx) { err += dx; y1 += sy; } } }

4.3 字体显示实现

显示字符需要字模数据。可以使用PCtoLCD2003等工具提取字模：

// 6x8 ASCII字体 const uint8_t Font6x8[][6] = { {0x00,0x00,0x00,0x00,0x00,0x00}, // 空格 {0x00,0x00,0x5F,0x00,0x00,0x00}, // ! // ... 更多字符定义 }; void OLED_ShowChar(uint8_t x, uint8_t y, char chr) { if(chr < ' ' || chr > '~') chr = ' '; uint8_t page = y / 8; uint8_t offset = y % 8; for(uint8_t i=0; i<6; i++) { uint8_t data = Font6x8[chr-' '][i]; if(offset) { OLED_GRAM[page][x+i] |= (data << offset); OLED_GRAM[page+1][x+i] |= (data >> (8-offset)); } else { OLED_GRAM[page][x+i] = data; } } } void OLED_ShowString(uint8_t x, uint8_t y, char *str) { while(*str) { OLED_ShowChar(x, y, *str++); x += 6; if(x > 122) { x = 0; y += 8; } } }

对于中文字符，需要16x16点阵字库，可以使用外部Flash存储完整字库，或者只包含项目需要的汉字。

5. 常见问题排查与性能优化

5.1 屏幕无显示的排查步骤

1. 检查电源：用万用表测量VCC和GND之间电压是否为3.3V
2. 检查复位信号：RES引脚应该先低电平至少3ms，然后变高
3. 验证SPI信号：用逻辑分析仪抓取SPI波形，确认时钟和数据线有信号
4. 检查初始化序列：确认发送了完整的初始化命令
5. 测试背板电压：有些屏幕需要调节VCOMH电压才能显示

5.2 显示异常的可能原因

• 鬼影/残影：预充电周期设置不当，尝试调整命令0xD9的值
• 显示错位：GDDRAM地址模式设置错误，检查命令0x20的设置
• 对比度异常：调节命令0x81的值（通常0xCF效果较好）
• 闪烁：刷新率太低，尝试提高SPI时钟频率或优化刷新逻辑

5.3 性能优化技巧

1. 局部刷新：只更新屏幕变化的部分，减少数据传输量
2. DMA传输：使用DMA自动发送显存数据，解放CPU资源
3. 双缓冲：维护两个显存，一个用于绘制，一个用于显示
4. SPI时钟提速：在屏幕允许范围内尽可能提高SPI速度
5. 指令合并：将多个命令/数据连续发送，减少CS切换开销

// 使用DMA优化刷新示例 void OLED_Refresh_DMA(void) { static uint8_t init_cmd[] = {0xB0,0x00,0x10}; // 页地址+列地址 for(uint8_t i=0; i<8; i++) { init_cmd[0] = 0xB0 + i; OLED_DC_LOW(); SPI_SendData_DMA(CW_SPI1, init_cmd, 3); OLED_DC_HIGH(); SPI_SendData_DMA(CW_SPI1, OLED_GRAM[i], 128); } }

5.4 低功耗优化

OLED屏幕本身功耗很低，但还可以进一步优化：

1. 睡眠模式：不显示时发送0xAE命令关闭显示
2. 降低刷新率：静态画面可以降低刷新频率
3. 动态对比度：根据环境光调整对比度
4. SPI时钟调节：显示时用高速SPI，待机时降低时钟

通过以上步骤，我们完成了CW32饭盒派开发板驱动OLED屏幕的整个过程。从硬件连接到软件实现，从基础显示到性能优化，这套方案可以应用于各种嵌入式显示需求。实际项目中，还可以进一步封装成图形库，或者添加菜单、动画等高级功能。