1.3寸单色OLED显示屏

1. 模块来源

采购链接：

黄保凯中景园1.3寸OLED显示屏12864液晶屏sh1106 12864 OLED模块

资料下载链接：

https://pan.baidu.com/s/1FNGHM0u5MQ2li3QOrTkTuA 资料提取码：8888

2. 规格参数

以下信息见厂家资料屏幕规格书。

工作电压：3.3V ~ 5V

工作电流：20mA

模块尺寸：33.5 x 35.4 MM

像素间距：0.23(H) x 0.23(V)

像素尺寸：0.21(H) x 0.21(V)

驱动芯片：SH1106

通信协议：SPI（可调IIC）

3. 移植过程

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

将源码导入工程；
根据编译报错处进行粗改；
修改引脚配置；
修改时序配置；
移植验证。

3.1 查看资料

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

3.2 移植至工程

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

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

将oled.h文件下的 sys.h 改为 board.h。

将oled.c文件下的 delay.h 注释掉。

3.3 引脚选择

该屏幕需要设置8个接口，具体接口说明见下表各引脚说明。

模块为SPI通信协议的从机，SCL为SPI信号线（SCK），SDA为SPI输出线（MOSI），CS为SPI片选线（NSS）。

如果MCU的GPIO引脚不足，可以将屏幕的两个引脚接口不接入MCU的GPIO。
将RES接入MCU的复位引脚，当MCU复位时，屏幕也跟着复位；

下面分为软件SPI移植与硬件SPI移植进行讲解。

3.3.1 软件SPI移植

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

在oled.h中添加OLED的引脚移植定义

//-----------------OLED端口移植定义----------------

#define OLED_RCC_GPIO_ENABLE()        __RCC_GPIOA_CLK_ENABLE()

#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

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

//OLED的初始化
void OLED_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化结构体

    OLED_RCC_GPIO_ENABLE();        // 使能GPIO时钟

    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); /*display off*/
    OLED_WR_Byte(0x02,OLED_CMD); /*set lower column address*/
    OLED_WR_Byte(0x10,OLED_CMD); /*set higher column address*/
    OLED_WR_Byte(0x40,OLED_CMD); /*set display start line*/
    OLED_WR_Byte(0xB0,OLED_CMD); /*set page address*/
    OLED_WR_Byte(0x81,OLED_CMD); /*contract control*/
    OLED_WR_Byte(0xcf,OLED_CMD); /*128*/
    OLED_WR_Byte(0xA1,OLED_CMD); /*set segment remap*/
    OLED_WR_Byte(0xA6,OLED_CMD); /*normal / reverse*/
    OLED_WR_Byte(0xA8,OLED_CMD); /*multiplex ratio*/
    OLED_WR_Byte(0x3F,OLED_CMD); /*duty = 1/64*/
    OLED_WR_Byte(0xad,OLED_CMD); /*set charge pump enable*/
    OLED_WR_Byte(0x8b,OLED_CMD); /* 0x8B 内供 VCC */
    OLED_WR_Byte(0x33,OLED_CMD); /*0X30---0X33 set VPP 9V */
    OLED_WR_Byte(0xC8,OLED_CMD); /*Com scan direction*/
    OLED_WR_Byte(0xD3,OLED_CMD); /*set display offset*/
    OLED_WR_Byte(0x00,OLED_CMD); /* 0x20 */
    OLED_WR_Byte(0xD5,OLED_CMD); /*set osc division*/
    OLED_WR_Byte(0x80,OLED_CMD);
    OLED_WR_Byte(0xD9,OLED_CMD); /*set pre-charge period*/
    OLED_WR_Byte(0x1f,OLED_CMD); /*0x22*/
    OLED_WR_Byte(0xDA,OLED_CMD); /*set COM pins*/
    OLED_WR_Byte(0x12,OLED_CMD);
    OLED_WR_Byte(0xdb,OLED_CMD); /*set vcomh*/
    OLED_WR_Byte(0x40,OLED_CMD);
    OLED_Clear();
    OLED_WR_Byte(0xAF,OLED_CMD); /*display ON*/
}

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

//-----------------OLED端口定义----------------

#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节进行移植验证。

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.h中添加OLED的引脚移植定义

//-----------------OLED端口移植定义----------------

#define OLED_RCC_GPIO_ENABLE()  __RCC_GPIOA_CLK_ENABLE()
#define OLED_RCC_SPI1_ENABLE()  __RCC_SPI1_CLK_ENABLE()

//GPIO AF
#define SPI1_AF_SCK()           PA05_AFx_SPI1SCK()
#define SPI1_AF_MOSI()          PA07_AFx_SPI1MOSI()

#define BSP_SPI1                CW_SPI1

#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

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

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

//OLED的初始化
void OLED_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化结构体

    OLED_RCC_GPIO_ENABLE();  // 使能GPIO时钟
    OLED_RCC_SPI1_ENABLE();  // 使能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); /*display off*/
    OLED_WR_Byte(0x02,OLED_CMD); /*set lower column address*/
    OLED_WR_Byte(0x10,OLED_CMD); /*set higher column address*/
    OLED_WR_Byte(0x40,OLED_CMD); /*set display start line*/
    OLED_WR_Byte(0xB0,OLED_CMD); /*set page address*/
    OLED_WR_Byte(0x81,OLED_CMD); /*contract control*/
    OLED_WR_Byte(0xcf,OLED_CMD); /*128*/
    OLED_WR_Byte(0xA1,OLED_CMD); /*set segment remap*/
    OLED_WR_Byte(0xA6,OLED_CMD); /*normal / reverse*/
    OLED_WR_Byte(0xA8,OLED_CMD); /*multiplex ratio*/
    OLED_WR_Byte(0x3F,OLED_CMD); /*duty = 1/64*/
    OLED_WR_Byte(0xad,OLED_CMD); /*set charge pump enable*/
    OLED_WR_Byte(0x8b,OLED_CMD); /* 0x8B 内供 VCC */
    OLED_WR_Byte(0x33,OLED_CMD); /*0X30---0X33 set VPP 9V */
    OLED_WR_Byte(0xC8,OLED_CMD); /*Com scan direction*/
    OLED_WR_Byte(0xD3,OLED_CMD); /*set display offset*/
    OLED_WR_Byte(0x00,OLED_CMD); /* 0x20 */
    OLED_WR_Byte(0xD5,OLED_CMD); /*set osc division*/
    OLED_WR_Byte(0x80,OLED_CMD);
    OLED_WR_Byte(0xD9,OLED_CMD); /*set pre-charge period*/
    OLED_WR_Byte(0x1f,OLED_CMD); /*0x22*/
    OLED_WR_Byte(0xDA,OLED_CMD); /*set COM pins*/
    OLED_WR_Byte(0x12,OLED_CMD);
    OLED_WR_Byte(0xdb,OLED_CMD); /*set vcomh*/
    OLED_WR_Byte(0x40,OLED_CMD);
    OLED_Clear();
    OLED_WR_Byte(0xAF,OLED_CMD); /*display ON*/
}

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

//-----------------OLED端口定义----------------

#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，时序是由厂家编写完成的。我们使用硬件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节进行移植验证。

4 移植验证

在main.c中输入代码如下

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：https://oshwhub.com/forum
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2024-06-19     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();

    uint32_t t = 0;

    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_ShowString(50,8,(uint8_t *)"Num:",16,1);//12*24 “ABC”
        OLED_ShowNum(90,8,t,3,16,1);
        t += 1;

        OLED_Refresh();
        delay_ms(1000);
    }
}

上电效果：

移植成功案例：

链接：https://pan.baidu.com/s/1t08db9FJIMY00ys3gNvPag?pwd=LCKF 提取码：LCKF

入门教程资料

模块移植手册

显示类

传感器类

无线通信类

控制类

电压电流表训练营资料

1.3寸单色OLED显示屏

1. 模块来源

2. 规格参数

3. 移植过程

3.1 查看资料

3.2 移植至工程

3.3 引脚选择

3.3.1 软件SPI移植

3.3.2 硬件SPI移植

4 移植验证

显示类

传感器类

无线通信类

控制类

1.3寸单色OLED显示屏 ​

1. 模块来源 ​

2. 规格参数 ​

3. 移植过程 ​

3.1 查看资料 ​

3.2 移植至工程 ​

3.3 引脚选择 ​

3.3.1 软件SPI移植 ​

3.3.2 硬件SPI移植 ​

4 移植验证 ​

1.3寸单色OLED显示屏

1. 模块来源

2. 规格参数

3. 移植过程

3.1 查看资料

3.2 移植至工程

3.3 引脚选择

3.3.1 软件SPI移植

3.3.2 硬件SPI移植

4 移植验证