0.96寸SPI单色屏 | 立创开发板技术文档中心

一、模块来源

采购链接：黄保凯中景园0.96寸OLED显示屏12864液晶屏12864显示屏ssd1306

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

资料提取码：g4xn

二、规格参数

工作电压：3.3V

工作电流：15MA

模块尺寸：27.3 x 27.8 MM

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

驱动芯片：SSD1306

通信协议：SPI

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

以上信息见厂家资料文件

三、移植过程

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

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

1、查看资料

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

2、移植至工程

将厂家资料路径下的【OLED】文件夹，复制到自己的工程中的BSP文件夹中。（工程可以参考入门手册工程模板）

我们打开工程文件，将我们刚刚复制到文件夹中的文件，导入C文件和路径。

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

TIP

(在左边将 oled.h 的工程目录展开，就发现有 oled.h )

#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

然后我们将 oled.c 文件中的 #include "delay.h" 换成 #include "board.h"。

3、引脚选择

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

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

软件SPI移植

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

选择好引脚后，进入工程开始修改初始化代码。

将 oled.c 源代码中的 void OLED_Init(void) 修改为如下代码。

//OLED的初始化
void OLED_Init(void)
{
    GPIO_InitTypeDef  GPIO_InitStructure;

    RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA,ENABLE);//使能PORTA时钟

    //GPIO初始化设置
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2|GPIO_Pin_3|GPIO_Pin_4|GPIO_Pin_5|GPIO_Pin_7;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;//普通输出模式
    GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;//推挽输出
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;//100MHz
    GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_UP;//上拉
    GPIO_Init(GPIOA, &GPIO_InitStructure);//初始化

    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端口定义----------------
/*
D0(SCK) = PA5
D1(MOSI) = PA7
RES = PA3
DC  = PA2
CS  = PA4
*/
#define OLED_SCL_Clr() GPIO_ResetBits(GPIOA,GPIO_Pin_5)//SCL
#define OLED_SCL_Set() GPIO_SetBits(GPIOA,GPIO_Pin_5)

#define OLED_SDA_Clr() GPIO_ResetBits(GPIOA,GPIO_Pin_7)//SDA
#define OLED_SDA_Set() GPIO_SetBits(GPIOA,GPIO_Pin_7)

#define OLED_RES_Clr() GPIO_ResetBits(GPIOA,GPIO_Pin_3)//RES
#define OLED_RES_Set() GPIO_SetBits(GPIOA,GPIO_Pin_3)

#define OLED_DC_Clr()  GPIO_ResetBits(GPIOA,GPIO_Pin_2)//DC
#define OLED_DC_Set()  GPIO_SetBits(GPIOA,GPIO_Pin_2)

#define OLED_CS_Clr()  GPIO_ResetBits(GPIOA,GPIO_Pin_4)//CS
#define OLED_CS_Set()  GPIO_SetBits(GPIOA,GPIO_Pin_4)

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

硬件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_InitStructure1;
        GPIO_InitTypeDef  GPIO_InitStructure2;
        SPI_InitTypeDef   SPI_InitStructure;

        RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);//使能PORTA时钟
        RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE);

        /* 配置SPI引脚引脚*/
        GPIO_InitStructure1.GPIO_Pin = GPIO_Pin_5|GPIO_Pin_7;
        GPIO_InitStructure1.GPIO_Speed = GPIO_Speed_50MHz;
        GPIO_InitStructure1.GPIO_Mode = GPIO_Mode_AF_PP;

        GPIO_Init(GPIOA, &GPIO_InitStructure1);

        GPIO_InitStructure2.GPIO_Pin =  GPIO_Pin_3|
                                        GPIO_Pin_2|
                                        GPIO_Pin_4;
        GPIO_InitStructure2.GPIO_Mode = GPIO_Mode_Out_PP;//推挽输出模式
        GPIO_InitStructure2.GPIO_Speed = GPIO_Speed_50MHz;//50MHz
        GPIO_Init(GPIOA, &GPIO_InitStructure2);//初始化
        GPIO_SetBits(GPIOA, GPIO_Pin_3|
                            GPIO_Pin_2|
                            GPIO_Pin_4 );
        /* FLASH_SPI 模式配置 */
        SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;
        SPI_InitStructure.SPI_Mode = SPI_Mode_Master;            // 配置为主机
        SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b;        // 8位数据
        SPI_InitStructure.SPI_CPOL = SPI_CPOL_High;
        SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge;             // 极性相位
        SPI_InitStructure.SPI_NSS = SPI_NSS_Soft;                // 软件cs
        SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_4; // SPI时钟预调因数为2
        SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;        //高位在前
        SPI_InitStructure.SPI_CRCPolynomial = 7;
        SPI_Init(SPI1, &SPI_InitStructure);

        /* 使能 SPI1  */
        SPI_Cmd(SPI1, ENABLE);

        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端口定义----------------
/*
D0(SCK) = PA5
D1(MOSI) = PA7
RES = PA3
DC  = PA2
CS  = PA4
*/
#define OLED_SCL_Clr() GPIO_ResetBits(GPIOA,GPIO_Pin_5)//SCL
#define OLED_SCL_Set() GPIO_SetBits(GPIOA,GPIO_Pin_5)

#define OLED_SDA_Clr() GPIO_ResetBits(GPIOA,GPIO_Pin_7)//SDA
#define OLED_SDA_Set() GPIO_SetBits(GPIOA,GPIO_Pin_7)

#define OLED_RES_Clr() GPIO_ResetBits(GPIOA,GPIO_Pin_3)//RES
#define OLED_RES_Set() GPIO_SetBits(GPIOA,GPIO_Pin_3)

#define OLED_DC_Clr()  GPIO_ResetBits(GPIOA,GPIO_Pin_2)//DC
#define OLED_DC_Set()  GPIO_SetBits(GPIOA,GPIO_Pin_2)

#define OLED_CS_Clr()  GPIO_ResetBits(GPIOA,GPIO_Pin_4)//CS
#define OLED_CS_Set()  GPIO_SetBits(GPIOA,GPIO_Pin_4)

初始化部分完，还需要修改发送数据部分。源代码中使用的是软件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(RESET == SPI_I2S_GetFlagStatus(SPI1,  SPI_I2S_FLAG_TXE) );
    //通过SPI1发送一个字节数据
    SPI_I2S_SendData(SPI1, dat);

    //等待接收缓冲区不空标志
    while(RESET == SPI_I2S_GetFlagStatus(SPI1,  SPI_I2S_FLAG_RXNE) );
    SPI_I2S_ReceiveData(SPI1);

    OLED_CS_Set();
    OLED_DC_Set();
}

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

四、移植验证

在main.c中输入代码如下:

/*
 * 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
 * 开发板官网：www.lckfb.com
 * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
 * 立创论坛：https://oshwhub.com/forum
 * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
 * 不靠卖板赚钱，以培养中国工程师为己任
 * Change Logs:
 * Date           Author       Notes
 * 2024-03-28     LCKFB-LP    first version
 */
#include "stm32f10x.h"
#include "board.h"
#include "bsp_uart.h"
#include "stdio.h"
#include "oled.h"

int main(void)
{

    board_init();

    uart1_init(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);
    }

}

上电效果：

【百度网盘下载链接】

链接：https://pan.baidu.com/s/1lXmMRhD79WD-1R-TFCnY7Q?pwd=bbic

提取码：bbic

标准库入门教程资料

模块移植手册

显示类

传感器类

无线通信类

控制类

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、移植至工程

3、引脚选择

软件SPI移植

硬件SPI移植

四、移植验证

显示类

传感器类

无线通信类

控制类

​

一、模块来源 ​

二、规格参数 ​

三、移植过程 ​

1、查看资料 ​

2、移植至工程 ​

3、引脚选择 ​

软件SPI移植 ​

硬件SPI移植 ​

四、移植验证 ​

一、模块来源

二、规格参数

三、移植过程

1、查看资料

2、移植至工程

3、引脚选择

软件SPI移植

硬件SPI移植

四、移植验证