0.96寸SPI单色屏

模块来源

采购链接：
https://item.taobao.com/item.htm?id=37849023766&_u=n1q56pn343e4

资料下载链接：
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间距排针）

移植过程

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

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

查看资料

打开厂家资料例程。具体路径见图1.6.3.1 例程路径

移植至工程

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

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

接下来导入h文件路径到工程。

把main.c、oled.c和oled.h文件中的头文件语句换成下面的（根据注释替换不同的头文件语句）。

// main.c
#include "gd32e23x.h"
#include "systick.h"
#include <stdio.h>
#include "oled.h"

// oled.h
#include "gd32e23x.h"
#include "stdlib.h"
#include "systick.h"

// oled.c
#include "oled.h"
#include "oledfont.h"
#include "bmp.h"

现在编译一下，发现u8、 u16和u32无法被识别

所以，分别在oled.h文件中定义三个宏，u32、u16与u8。

#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

再编译发现只剩下LCD引脚初始化的内容报错，接下来我们要进行引脚选择。

引脚选择

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

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

软件SPI移植

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

选择好引脚后，进入工程开始编写屏幕引脚初始化代码。为了方便后续移植，我在oled.h处宏定义了每一个引脚，后续根据需要进行修改即可。

//-----------------OLED端口移植----------------
//VCC - 3.3V
//D0 - PA1
//D1 - PA2
//RES - PA3（可以接入复位）
//DC  - PA4
//CS  - PA5
#define RCU_LCD_D0     RCU_GPIOA//SCK
#define PORT_LCD_D0    GPIOA
#define GPIO_LCD_D0    GPIO_PIN_1

#define RCU_LCD_D1     RCU_GPIOA//MOSI
#define PORT_LCD_D1    GPIOA
#define GPIO_LCD_D1    GPIO_PIN_2

#define RCU_LCD_CS      RCU_GPIOA//NSS
#define PORT_LCD_CS     GPIOA
#define GPIO_LCD_CS     GPIO_PIN_5

#define RCU_LCD_DC      RCU_GPIOA //DC
#define PORT_LCD_DC     GPIOA
#define GPIO_LCD_DC     GPIO_PIN_4

#define RCU_LCD_RES     RCU_GPIOA//RES
#define PORT_LCD_RES    GPIOA
#define GPIO_LCD_RES    GPIO_PIN_3

//#define RCU_SPI_HARDWARE RCU_SPI1
//#define PORT_SPI         SPI1
//#define LINE_AF_SPI      GPIO_AF_5

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

//OLED的初始化
void OLED_Init(void)
{
                /* 使能时钟 */
        rcu_periph_clock_enable(RCU_LCD_D0);
        rcu_periph_clock_enable(RCU_LCD_D1);
        rcu_periph_clock_enable(RCU_LCD_CS);
        rcu_periph_clock_enable(RCU_LCD_DC);
        rcu_periph_clock_enable(RCU_LCD_RES);

                                         /* 配置SCL */
        gpio_mode_set(PORT_LCD_D0,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_D0);
        gpio_output_options_set(PORT_LCD_D0,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_D0);
        gpio_bit_write(PORT_LCD_D0, GPIO_LCD_D0, SET);

                                         /* 配置SDA */
        gpio_mode_set(PORT_LCD_D1,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_D1);
        gpio_output_options_set(PORT_LCD_D1,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_D1);
        gpio_bit_write(PORT_LCD_D1, GPIO_LCD_D1, SET);

                                         /* 配置DC */
        gpio_mode_set(PORT_LCD_DC,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_DC);
        gpio_output_options_set(PORT_LCD_DC,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_DC);
        gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET);

                                         /* 配置CS */
        gpio_mode_set(PORT_LCD_CS,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_CS);
        gpio_output_options_set(PORT_LCD_CS,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_CS);
        gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET);

                                         /* 配置RES */
        gpio_mode_set(PORT_LCD_RES,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_RES);
        gpio_output_options_set(PORT_LCD_RES,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_RES);
        gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET);

        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端口定义宏，修改为图1.6.3.20样式。

#define OLED_SCL_Clr() gpio_bit_write(PORT_LCD_D0, GPIO_LCD_D0, RESET)//SCL=SCLK
#define OLED_SCL_Set() gpio_bit_write(PORT_LCD_D0, GPIO_LCD_D0, SET)

#define OLED_SDA_Clr() gpio_bit_write(PORT_LCD_D1, GPIO_LCD_D1, RESET)//SDA=MOSI
#define OLED_SDA_Set()  gpio_bit_write(PORT_LCD_D1, GPIO_LCD_D1, SET)

#define OLED_RES_Clr()  gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, RESET)//RES
#define OLED_RES_Set()  gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET)

#define OLED_DC_Clr()   gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, RESET)//DC
#define OLED_DC_Set()   gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET)

#define OLED_CS_Clr()   gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, RESET)//CS
#define OLED_CS_Set()   gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET)

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

移植验证

在main.c中输入代码如下

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include <stdio.h>
#include "oled.h"

int main(void)
{
        systick_config();                //滴答定时器初始化 1ms
        OLED_Init();                     //初始化OLED
        OLED_Clear();
        while(1)
        {
                OLED_ShowString(0,0,"ABC",8,1);//6*8 “ABC”
                OLED_ShowString(0,8,"ABC",12,1);//6*12 “ABC”
                OLED_ShowString(0,20,"ABC",16,1);//8*16 “ABC”
                OLED_ShowString(0,36,"ABC",24,1);//12*24 “ABC”
                OLED_Refresh();
                delay_1ms(500);
        }
}

上电效果

文件下载

📌 资料下载中心（点击跳转）

📌 在 资料下载中心->【模块移植手册资料下载】 里面的本章节压缩包中。

显示类

传感器类

无线通信类

控制类

0.96寸SPI单色屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件SPI移植

移植验证

0.96寸SPI单色屏 ​

模块来源 ​

规格参数 ​

移植过程 ​

查看资料 ​

移植至工程 ​

引脚选择 ​

软件SPI移植 ​

移植验证 ​

0.96寸SPI单色屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件SPI移植

移植验证