简体中文

English

简体中文

English

外观

0.91寸彩屏 ​

模块来源 ​

采购链接：
https://item.taobao.com/item.htm?spm=a1z09.2.0.0.38ec2e8dwBMLLQ&id=39454653104&_u=d2t4uge5e573
资料下载链接：
https://pan.baidu.com/s/1fKmD5lr4bA0WB54ukonI-A
资料提取码：1111

规格参数 ​

工作电压：3~5V
工作电流：最大16mA
模块尺寸：12(H) x 38(V) MM
像素大小：128(H) x 32(V)
驱动芯片：SSD1306
通信协议：IIC

移植过程 ​

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

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

查看资料 ​

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

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

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

移植至工程 ​

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

接下来我们打开工程，添加C文件到工程中。

接下来我们添加h文件路径到工程中。

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

c
#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

然后我们在文件中修改语句：

c
// main.c
#include "gd32e23x.h"
#include "systick.h"
#include "oled.h"
c
// oled.c
#include "oled.h"
#include "stdlib.h"
#include "oledfont.h"
```c // oled.h #include "systick.h" #include "stdlib.h" #include "stdio.h" #include "gd32e23x.h" ```

引脚选择 ​

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

软件IIC移植 ​

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

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

c
//-----------------OLED端口移植----------------
//GND - GND
//VCC - 3.3V
//SCL - PA0 I2C1_SCL
//SDA - PA1 I2C1_SDA
#define RCU_LCD_SCL     RCU_GPIOA//SCL
#define PORT_LCD_SCL    GPIOA
#define GPIO_LCD_SCL    GPIO_PIN_0

#define RCU_LCD_SDA     RCU_GPIOA//SDA
#define PORT_LCD_SDA    GPIOA
#define GPIO_LCD_SDA    GPIO_PIN_1

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

c
//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); /*display off*/
        OLED_WR_Byte(0x00,OLED_CMD); /*set lower column address*/
        OLED_WR_Byte(0x10,OLED_CMD); /*set higher column address*/
        OLED_WR_Byte(0x00,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(0xff,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(0x1F,OLED_CMD); /*duty = 1/32*/
        OLED_WR_Byte(0xC8,OLED_CMD); /*Com scan direction*/
        OLED_WR_Byte(0xD3,OLED_CMD); /*set display offset*/
        OLED_WR_Byte(0x00,OLED_CMD);
        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);
        OLED_WR_Byte(0xDA,OLED_CMD); /*set COM pins*/
        OLED_WR_Byte(0x00,OLED_CMD);
        OLED_WR_Byte(0xdb,OLED_CMD); /*set vcomh*/
        OLED_WR_Byte(0x40,OLED_CMD);
        OLED_WR_Byte(0x8d,OLED_CMD); /*set charge pump enable*/
        OLED_WR_Byte(0x14,OLED_CMD);
        OLED_Clear();
        OLED_WR_Byte(0xAF,OLED_CMD); /*display ON*/
}

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

c
#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就移植完成了，请移步到1.17.4节进行移植验证。

移植验证 ​

在main.c中输入代码如下

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(20,8,"ABC",16,1);//8*16 “ABC”
                OLED_ShowString(45,36,"ABC",24,1);//12*24 “ABC”
                OLED_Refresh();
                delay_1ms(100);
        }
}

上电效果

文件下载

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

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

本页面更新于: