【CW32模块使用】0.96寸SPI单色屏

一模块来源

模块实物展示：

资料下载链接：https://pan.baidu.com/s/1U9r32qeS2jOANB0SNwtwnw

资料提取码：8888

二规格参数

以下信息见厂家资料

工作电压：3.3V

工作电流：15MA

模块尺寸：27.3 x 27.8 MM

像素大小：128(H) x 64(V)RGB

驱动芯片：SSD1306

通信协议：SPI

管脚数量：7 Pin（2.54mm间距排针）

尺寸参数

三移植过程

3.1查看资料

我们的目标是将例程移植至立创·CW32F030C8T6开发板上。按照以下步骤，即可完成移植。

将源码导入工程；

根据编译报错处进行粗改；

修改引脚配置；

修改时序配置；

移植验证。

打开厂家资料例程（例程下载见网盘链接）。具体路径见下图。

3.2移植至工程

将厂家资料路径下的【OLED】文件夹，复制到自己的工程中。自己的工程至少需要有毫秒级延时函数。（工程可以参考入门手册）

打开自己的工程，将我们刚刚复制过来的文件导入.c和.h文件。

然后我们在 oled.h 中添加如下宏定义，将sys.h改为board.h

然后我们将 oled.c 文件中的 #include "delay.h" 注释掉。

3.3引脚选择

该屏幕需要设置7个接口，具体接口说明见下表。

模块为SPI通信协议的从机，D0为SPI信号线（SCK），D1为SPI输出线（MOSI），CS为SPI片选线（NSS）。下面分为软件SPI移植与硬件SPI移植进行讲解。

3.3.1软件SPI移植

当前厂家源码使用的是软件SPI接口，SPI时序部分厂家已经完成，我们只需要将引脚和延时配置好即可。所以对应接入的屏幕引脚请按照你的需要。这里选择的引脚见下表。

选择好引脚后，进入工程开始编写屏幕引脚初始化代码。将oled.c源代码中的 void OLED_Init(void) 修改为如下代码。

//OLED的初始化void OLED_Init(void){    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化结构体
    __RCC_GPIOA_CLK_ENABLE();           // 使能GPIOA时钟
    GPIO_InitStruct.Pins =  OLED_SCL_PIN| // GPIO引脚                            OLED_MOSI_PIN|                            OLED_RES_PIN|                            OLED_DC_PIN|                            OLED_CS_PIN;    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽输出    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 输出速度高    GPIO_Init(OLED_GPIO_PORT, &GPIO_InitStruct);   // 初始化
    OLED_RES_Clr();    delay_ms(200);    OLED_RES_Set();
    OLED_WR_Byte(0xAE,OLED_CMD);//--turn off oled panel    OLED_WR_Byte(0x00,OLED_CMD);//---set low column address    OLED_WR_Byte(0x10,OLED_CMD);//---set high column address    OLED_WR_Byte(0x40,OLED_CMD);//--set start line address  Set Mapping RAM Display Start Line (0x00~0x3F)    OLED_WR_Byte(0x81,OLED_CMD);//--set contrast control register    OLED_WR_Byte(0xCF,OLED_CMD);// Set SEG Output Current Brightness    OLED_WR_Byte(0xA1,OLED_CMD);//--Set SEG/Column Mapping     0xa0左右反置 0xa1正常    OLED_WR_Byte(0xC8,OLED_CMD);//Set COM/Row Scan Direction   0xc0上下反置 0xc8正常    OLED_WR_Byte(0xA6,OLED_CMD);//--set normal display    OLED_WR_Byte(0xA8,OLED_CMD);//--set multiplex ratio(1 to 64)    OLED_WR_Byte(0x3f,OLED_CMD);//--1/64 duty    OLED_WR_Byte(0xD3,OLED_CMD);//-set display offset        Shift Mapping RAM Counter (0x00~0x3F)    OLED_WR_Byte(0x00,OLED_CMD);//-not offset    OLED_WR_Byte(0xd5,OLED_CMD);//--set display clock divide ratio/oscillator frequency    OLED_WR_Byte(0x80,OLED_CMD);//--set divide ratio, Set Clock as 100 Frames/Sec    OLED_WR_Byte(0xD9,OLED_CMD);//--set pre-charge period    OLED_WR_Byte(0xF1,OLED_CMD);//Set Pre-Charge as 15 Clocks & Discharge as 1 Clock    OLED_WR_Byte(0xDA,OLED_CMD);//--set com pins hardware configuration    OLED_WR_Byte(0x12,OLED_CMD);    OLED_WR_Byte(0xDB,OLED_CMD);//--set vcomh    OLED_WR_Byte(0x40,OLED_CMD);//Set VCOM Deselect Level    OLED_WR_Byte(0x20,OLED_CMD);//-Set Page Addressing Mode (0x00/0x01/0x02)    OLED_WR_Byte(0x02,OLED_CMD);//    OLED_WR_Byte(0x8D,OLED_CMD);//--set Charge Pump enable/disable    OLED_WR_Byte(0x14,OLED_CMD);//--set(0x10) disable    OLED_WR_Byte(0xA4,OLED_CMD);// Disable Entire Display On (0xa4/0xa5)    OLED_WR_Byte(0xA6,OLED_CMD);// Disable Inverse Display On (0xa6/a7)    OLED_Clear();    OLED_WR_Byte(0xAF,OLED_CMD);}

将lcd_init.h中的 OLED端口定义宏，进行修改，修改为下图中右图的样式。

//-----------------OLED端口定义----------------
#define OLED_GPIO_PORT      CW_GPIOA
#define OLED_SCL_PIN        GPIO_PIN_5#define OLED_MOSI_PIN       GPIO_PIN_7#define OLED_RES_PIN        GPIO_PIN_3#define OLED_DC_PIN         GPIO_PIN_2#define OLED_CS_PIN         GPIO_PIN_4


#define OLED_SCL_Clr() GPIO_WritePin(OLED_GPIO_PORT, OLED_SCL_PIN, GPIO_Pin_RESET)//SCL#define OLED_SCL_Set() GPIO_WritePin(OLED_GPIO_PORT, OLED_SCL_PIN, GPIO_Pin_SET)
#define OLED_SDA_Clr() GPIO_WritePin(OLED_GPIO_PORT, OLED_MOSI_PIN, GPIO_Pin_RESET)//SDA#define OLED_SDA_Set() GPIO_WritePin(OLED_GPIO_PORT, OLED_MOSI_PIN, GPIO_Pin_SET)
#define OLED_RES_Clr() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_RESET)//RES#define OLED_RES_Set() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_SET)
#define OLED_DC_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_RESET)//DC#define OLED_DC_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_SET)
#define OLED_CS_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_RESET)//CS#define OLED_CS_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_SET)

到这里软件SPI就移植完成了，可移步到4节进行移植验证。

源端口定义

修改后端口定义

到这里软件SPI就移植完成了，请移步到第4节进行移植验证。

3.3.2硬件SPI移植

硬件SPI与软件SPI相比，硬件SPI是靠硬件上面的SPI控制器，所有的时钟边缘采样，时钟发生，还有时序控制，都是由硬件完成的。它降低了CPU的使用率，提高了运行速度。软件SPI就是用代码控制IO输出高低电平，模拟SPI的时序，这种方法通信速度较慢，且不可靠。

想要使用硬件SPI驱动屏幕，需要确定使用的引脚是否有SPI外设功能。可以通过数据手册进行查看。

说明

数据手册和用户手册都在百度网盘资料，网盘地址看入门手册。

当前使用的是硬件SPI接口，而屏幕我们只需要控制它，而不需要读取屏幕的数据，故使用的是3线的SPI，只使用到了时钟线SCK、主机输出从机输入线MOSI和软件控制的片选线NSS。而NSS我们使用的是软件控制，所以除了SCL(SCK)/SDA(MOSI)引脚需要使用硬件SPI功能的引脚外，其他引脚都可以使用开发板上其他的GPIO。这里选择使用PA5/PA7的SPI复用功能。其他对应接入的屏幕引脚请按照你的需要。这里选择的引脚见表硬件SPI接线.

接线图

选择好引脚后，进入工程开始编写屏幕引脚初始化代码。

引脚初始化配置见如下代码。

//OLED的初始化void OLED_Init(void){    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化结构体
    __RCC_GPIOA_CLK_ENABLE();           // 使能GPIOA时钟    __RCC_SPI1_CLK_ENABLE();            // 使能SPI1时钟
    // GPIO复用为SPI1    SPI1_AF_SCK();    SPI1_AF_MOSI();
    GPIO_InitStruct.Pins =  OLED_SCL_PIN| // GPIO引脚                            OLED_MOSI_PIN|                            OLED_RES_PIN|                            OLED_DC_PIN|                            OLED_CS_PIN;    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽输出    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 输出速度高    GPIO_Init(OLED_GPIO_PORT, &GPIO_InitStruct);   // 初始化
    SPI_InitTypeDef  SPI_InitStructure; // SPI 初始化结构体
    SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;    // 双线全双工    SPI_InitStructure.SPI_Mode = SPI_Mode_Master;                         // 主机模式    SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b;                     // 帧数据长度为8bit    SPI_InitStructure.SPI_CPOL = SPI_CPOL_High;                           // 时钟空闲电平为高    SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge;                          // 第二个边沿采样    SPI_InitStructure.SPI_NSS = SPI_NSS_Soft;                             // 片选信号由SSI寄存器控制    SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_8;    // 波特率为PCLK的8分频    SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;                    // 最高有效位 MSB 收发在前    SPI_InitStructure.SPI_Speed = SPI_Speed_Low;                          // 低速SPI
    SPI_Init(BSP_SPI1, &SPI_InitStructure);   // 初始化    SPI_Cmd(BSP_SPI1, ENABLE); // 使能SPI1

    OLED_RES_Clr();    delay_ms(200);    OLED_RES_Set();
    OLED_WR_Byte(0xAE,OLED_CMD);//--turn off oled panel    OLED_WR_Byte(0x00,OLED_CMD);//---set low column address    OLED_WR_Byte(0x10,OLED_CMD);//---set high column address    OLED_WR_Byte(0x40,OLED_CMD);//--set start line address  Set Mapping RAM Display Start Line (0x00~0x3F)    OLED_WR_Byte(0x81,OLED_CMD);//--set contrast control register    OLED_WR_Byte(0xCF,OLED_CMD);// Set SEG Output Current Brightness    OLED_WR_Byte(0xA1,OLED_CMD);//--Set SEG/Column Mapping     0xa0左右反置 0xa1正常    OLED_WR_Byte(0xC8,OLED_CMD);//Set COM/Row Scan Direction   0xc0上下反置 0xc8正常    OLED_WR_Byte(0xA6,OLED_CMD);//--set normal display    OLED_WR_Byte(0xA8,OLED_CMD);//--set multiplex ratio(1 to 64)    OLED_WR_Byte(0x3f,OLED_CMD);//--1/64 duty    OLED_WR_Byte(0xD3,OLED_CMD);//-set display offset        Shift Mapping RAM Counter (0x00~0x3F)    OLED_WR_Byte(0x00,OLED_CMD);//-not offset    OLED_WR_Byte(0xd5,OLED_CMD);//--set display clock divide ratio/oscillator frequency    OLED_WR_Byte(0x80,OLED_CMD);//--set divide ratio, Set Clock as 100 Frames/Sec    OLED_WR_Byte(0xD9,OLED_CMD);//--set pre-charge period    OLED_WR_Byte(0xF1,OLED_CMD);//Set Pre-Charge as 15 Clocks & Discharge as 1 Clock    OLED_WR_Byte(0xDA,OLED_CMD);//--set com pins hardware configuration    OLED_WR_Byte(0x12,OLED_CMD);    OLED_WR_Byte(0xDB,OLED_CMD);//--set vcomh    OLED_WR_Byte(0x40,OLED_CMD);//Set VCOM Deselect Level    OLED_WR_Byte(0x20,OLED_CMD);//-Set Page Addressing Mode (0x00/0x01/0x02)    OLED_WR_Byte(0x02,OLED_CMD);//    OLED_WR_Byte(0x8D,OLED_CMD);//--set Charge Pump enable/disable    OLED_WR_Byte(0x14,OLED_CMD);//--set(0x10) disable    OLED_WR_Byte(0xA4,OLED_CMD);// Disable Entire Display On (0xa4/0xa5)    OLED_WR_Byte(0xA6,OLED_CMD);// Disable Inverse Display On (0xa6/a7)    OLED_Clear();    OLED_WR_Byte(0xAF,OLED_CMD);}

将oled.h中的 LCD端口定义宏，修改为下方两个图中右图的样式。

//-----------------OLED端口定义----------------
#define BSP_SPI1               CW_SPI1
//GPIO AF#define SPI1_AF_SCK()          PA05_AFx_SPI1SCK()#define SPI1_AF_MOSI()         PA07_AFx_SPI1MOSI()
#define OLED_GPIO_PORT         CW_GPIOA
#define OLED_SCL_PIN           GPIO_PIN_5#define OLED_MOSI_PIN          GPIO_PIN_7#define OLED_RES_PIN           GPIO_PIN_3#define OLED_DC_PIN            GPIO_PIN_2#define OLED_CS_PIN            GPIO_PIN_4

#define OLED_RES_Clr() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_RESET)//RES#define OLED_RES_Set() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_SET)
#define OLED_DC_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_RESET)//DC#define OLED_DC_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_SET)
#define OLED_CS_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_RESET)//CS#define OLED_CS_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_SET)

源端口定义

修改后端口定义

初始化部分完，还需要修改发送数据部分。源代码中使用的是软件SPI，时序是由厂家编写完成的。我们使用硬件SPI则需要对其进行修改。

在oled.c文件中，将源代码的 void OLED_WR_Byte(u8 dat,u8 cmd) 函数修改为下方两个图中右图的样式。

源代码格式

修改后的代码

void OLED_WR_Byte(u8 dat,u8 cmd){    if(cmd)      OLED_DC_Set();    else      OLED_DC_Clr();
    OLED_CS_Clr();
    while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_TXE) == RESET);
    SPI_SendData(BSP_SPI1, dat); // 发送数据
    while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_RXNE) == RESET);
    uint16_t temp = SPI_ReceiveData(BSP_SPI1); // 返回数据
    OLED_CS_Set();    OLED_DC_Set();}

到这里硬件SPI就移植完成了，请移步到4节进行移植验证。

四移植验证

在main.c中输入代码如下

/* * Change Logs: * Date           Author       Notes * 2024-06-18     LCKFB-LP    first version */#include "board.h"#include "stdio.h"#include "bsp_uart.h"#include "oled.h"
int32_t main(void){    board_init();        // 开发板初始化
    uart1_init(115200);        // 串口1波特率115200
    OLED_Init();    //初始化OLED    OLED_Clear();    while(1)    {        OLED_ShowString(0,0,(uint8_t *)"ABC",8,1);//6*8 “ABC”        OLED_ShowString(0,8,(uint8_t *)"ABC",12,1);//6*12 “ABC”        OLED_ShowString(0,20,(uint8_t *)"ABC",16,1);//8*16 “ABC”        OLED_ShowString(0,36,(uint8_t *)"ABC",24,1);//12*24 “ABC”        OLED_Refresh();        delay_ms(500);    }}