0.96寸IIC单色屏

模块来源

采购链接：
https://item.taobao.com/item.htm?spm=a1z10.5-c-s.w4002-23284685151.19.1ffe61919S9gQy&id=40809409804
资料下载链接：
https://pan.baidu.com/s/1xy2zH8-hs-S8-_AcVtBP_g
资料提取码：0jhj

规格参数

工作电压：3.3V
工作电流：9MA
模块尺寸：27.3 x 27.8 MM
像素大小：128(H) x 64(V)RGB
驱动芯片：SSD1306
通信协议：IIC
管脚数量：4 Pin（2.54mm间距排针）

移植过程

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

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

查看资料

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

在main.c文件发现对屏幕的初始化配置函数为 OLED_Init(); ，该函数里包含了对屏幕引脚的配置、对屏幕显示方式的配置。

我们主要修改的是引脚的初始化与时序的延时修改。

移植至工程

将上方我圈出来的那个例程中【HARDWARE】文件夹下的【LCD】文件夹，复制到自己的工程中的文件夹中的【Hardware】文件夹。自己的工程至少需要有毫秒级延时函数。（工程可以参考入门手册空白工程下载）

步骤和【1.9寸彩屏】几乎一样，除了文件名字一个是LCD，而这个是OLED。
不知道的可以点击回顾一下（点我跳转）。

接下来我们开始添加h文件的路径到工程

然后我们添加C文件到工程

尝试编译我们发现有一个错误，是关于sys.h文件的，说找不到这个文件。

将 oled.h 文件下的 sys.h 改为 gd32e23x.h (在左边将 oled.c 的工程目录展开，就发现有 oled.h )

再编译发现还有错误，错误内容分别为标识符“u8”、“u16”、“u32”未定义和找不到delay.h这个文件。

在oled.h文件中定义三个宏，u8、u16、u32。

// oled.h
#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

在源代码中使用delay.h的主要作用是给屏幕初始化时提供一定的延时，确保初始化成功。主要使用的函数是delay_ms，进行毫秒级延时。
将 oled.c 文件中的头文件 delay.h 改为自己的延时函数头文件，这里我使用的是 systick.h；再将文件中使用到的延时函数delay_ms替换为自己的毫秒级延时， 这里替换为 delay_1ms 。

#include "systick.h"

#define  delay_ms  delay_1ms

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

引脚选择

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

模块为IIC通信协议的从机，SCL为IIC信号线，SDA为IIC数据线。
下面分为软件IIC移植与硬件IIC移植进行讲解。

软件IIC移植

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

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

//-----------------OLED端口移植----------------
// GND - GND
// VCC - 3.3V
// SCL - PB8
// SDA - PB9
#define RCU_LCD_SCL     RCU_GPIOB//SCL
#define PORT_LCD_SCL    GPIOB
#define GPIO_LCD_SCL    GPIO_PIN_8

#define RCU_LCD_SDA     RCU_GPIOB//SDA
#define PORT_LCD_SDA    GPIOB
#define GPIO_LCD_SDA    GPIO_PIN_9

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

//OLED的初始化
void OLED_Init(void)
{
     /* 使能时钟 */
    rcu_periph_clock_enable(RCU_LCD_SCL);
    rcu_periph_clock_enable(RCU_LCD_SDA);
    /* 配置SCL */
    gpio_mode_set(PORT_LCD_SCL,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_SCL);
    gpio_output_options_set(PORT_LCD_SCL,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_SCL);
    gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, SET);

    /* 配置SDA */
    gpio_mode_set(PORT_LCD_SDA,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_SDA);
    gpio_output_options_set(PORT_LCD_SDA,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_SDA);
    gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, 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_SCL, GPIO_LCD_SCL, RESET)//SCL
#define OLED_SCL_Set() gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, SET)//SCL

#define OLED_SDA_Clr() gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, RESET)//SDA
#define OLED_SDA_Set()gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, SET)//SDA

//#define OLED_RES_Clr() GPIO_ResetBits(GPIOD,GPIO_Pin_4)//RES
//#define OLED_RES_Set() GPIO_SetBits(GPIOD,GPIO_Pin_4)

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

移植验证

在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 "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_ShowChinese(90,0,5,16,1);//技
         OLED_ShowChinese(108,0,6,16,1);//术

         OLED_Refresh();
         delay_1ms(500);
    }
}

上电效果

文件下载

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

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

显示类

传感器类

无线通信类

控制类

0.96寸IIC单色屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件IIC移植

移植验证

0.96寸IIC单色屏 ​

模块来源 ​

规格参数 ​

移植过程 ​

查看资料 ​

移植至工程 ​

引脚选择 ​

软件IIC移植 ​

移植验证 ​

0.96寸IIC单色屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件IIC移植

移植验证