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

移植过程

我们的目标是将例程移植至天空星GD32F407上。按照以下步骤，即可完成移植。

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

查看资料

打开厂家资料例程（例程下载见模块来源->资料下载）。具体路径见图1.17.3.1 例程路径。

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

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

移植至工程

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

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

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

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

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

#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

引脚选择

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

软件IIC移植

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

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

//-----------------OLED端口移植----------------
//GND - GND
//VCC - 3.3V
//SCL - PB10     I2C1_SCL
//SDA - PB11     I2C1_SDA
#define RCU_LCD_SCL     RCU_GPIOB//SCL
#define PORT_LCD_SCL    GPIOB
#define GPIO_LCD_SCL    GPIO_PIN_10

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

将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); /*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样式。

#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)

打开oled.c 文件，找到 void IIC_delay(void) 函数，修改为

//延时
void IIC_delay(void)
{
        delay_us(2);
}

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

硬件IIC移植

一般IIC协议的通讯可以使用IO软件模拟，也可以使用硬件IIC协议，软件IO模拟IIC，则无IO限制，但占用MCU的效率；硬件IIC通讯控制简单，但是需按外设对应IO进行连接，通讯控制也需按照寄存器进行相应操作（原厂一般也写好）。
硬件IIC的意思就是IIC时序方面，直接由硬件帮你完成，不需要去考虑时序错误的问题。硬件可以快一点，不占用MCU的效率，但是需要引脚具备IIC通信功能的。而软件IIC是由你编写代码实现的。比如什么时候高电平，什么时候低电平，高电平多长时间，低电平又多长时间等等，但是软件IIC可以是普通IO口，不需要具备硬件IIC接口也可以实现功能。
天空星的主控为GD32F407VET6，其带有3个IIC外设，可以通过简单的库函数调用，实现硬件IIC的通信。想要使用硬件IIC驱动屏幕，需要确定使用的引脚是否有IIC外设功能。可以通过数据手册【GD32F450xx_Datasheet_Rev2.2.pdf】进行查看。

在数据手册的第40页结尾，是关于GD32F450Zx系列芯片引脚的功能定义示意图。

当前使用的是硬件IIC接口，这里选择使用PB10/PB11的IIC复用功能。其他对应接入的屏幕引脚请按照你的需要。这里选择的引脚见表1.17.3.3 硬件IIC接线

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

//-----------------OLED端口移植----------------
//GND - GND
//VCC - 3.3V
//SCL - PB10     I2C1_SCL
//SDA - PB11     I2C1_SDA
#define RCU_LCD_SCL     RCU_GPIOB//SCL
#define PORT_LCD_SCL    GPIOB
#define GPIO_LCD_SCL    GPIO_PIN_10

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

#define I2C_TIME_OUT         50000
#define I2C_SPEED            400000
#define I2CX_SLAVE_ADDRESS7  0x78
#define I2CX                 I2C1
#define RCU_I2CX             RCU_I2C1
#define I2C_AF               GPIO_AF_4

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

//OLED的初始化
void OLED_Init(void)
{
    /* 使能引脚时钟 */
    rcu_periph_clock_enable(RCU_LCD_SCL);
    rcu_periph_clock_enable(RCU_LCD_SDA);

    /* 配置SCL引脚复用IIC功能 */
    gpio_af_set(PORT_LCD_SCL, I2C_AF, GPIO_LCD_SCL);
    /* 配置SDA引脚复用IIC功能 */
    gpio_af_set(PORT_LCD_SDA, I2C_AF, GPIO_LCD_SDA);

    /* 配置SCL引脚 */
    gpio_mode_set(PORT_LCD_SCL, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_LCD_SCL);
    gpio_output_options_set(PORT_LCD_SCL, GPIO_OTYPE_OD, GPIO_OSPEED_50MHZ, GPIO_LCD_SCL);
    /* 配置SDA引脚 */
    gpio_mode_set(PORT_LCD_SDA, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_LCD_SDA);
    gpio_output_options_set(PORT_LCD_SDA, GPIO_OTYPE_OD, GPIO_OSPEED_50MHZ, GPIO_LCD_SDA);

    /* 使能IIC时钟 */
    rcu_periph_clock_enable(RCU_I2CX);
    /* 清除IIC原先配置 */
    i2c_deinit(I2CX);
    /* 配置IIC时钟 */
    i2c_clock_config(I2CX, I2C_SPEED, I2C_DTCY_2);
    /* 配置I2C地址 */
    i2c_mode_addr_config(I2CX, I2C_I2CMODE_ENABLE, I2C_ADDFORMAT_7BITS, I2CX_SLAVE_ADDRESS7);
    /* 使能I2C */
    i2c_enable(I2CX);
    /* 使能应答功能 */
    i2c_ack_config(I2CX, I2C_ACK_ENABLE);

    //        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*/
}

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

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

#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，时序是由厂家编写完成的。我们使用硬件IIC则需要对其进行修改。
在oled.c文件中，将源代码的void OLED_WR_Byte(u8 dat,u8 cmd) 函数修改为图1.17.3.28样式。

void OLED_WR_Byte(u8 dat,u8 mode)
{
    /* 等待I2C总线空闲 */
    while(i2c_flag_get(I2CX, I2C_FLAG_I2CBSY));

    /* 发送起始信号到I2C总线 */
    i2c_start_on_bus(I2CX);

    /* 等待发送起始信号成功标志位为1 */
    while(!i2c_flag_get(I2CX, I2C_FLAG_SBSEND));

    /* 发送从机地址到I2C总线 */
    i2c_master_addressing(I2CX, I2CX_SLAVE_ADDRESS7, I2C_TRANSMITTER);

    /* 等待发送从机地址成功标志位为1 */
    while(!i2c_flag_get(I2CX, I2C_FLAG_ADDSEND));
    /* 清除发送从机地址成功标志位 */
    i2c_flag_clear(I2CX,I2C_FLAG_ADDSEND);

    /* 等待传输数据缓冲区为空 */
    while( SET != i2c_flag_get(I2CX, I2C_FLAG_TBE));

    /* 发送寄存器地址（发送命令） */
    if(mode){i2c_data_transmit(I2CX, 0x40);}
    else    {i2c_data_transmit(I2CX, 0x00);}

    /* 等待字节传输完成位设置完成 */
    while(!i2c_flag_get(I2CX, I2C_FLAG_BTC));

    /* 发送数据 */
    i2c_data_transmit(I2CX, dat);

    /* 等待字节传输完成位设置完成 */
    while(!i2c_flag_get(I2CX, I2C_FLAG_BTC));

    /* 向I2C总线发送停止信号 */
    i2c_stop_on_bus(I2CX);

    /* 等待直到停止信号发送完成  */
    while(I2C_CTL0(I2CX)&0x0200);
}

在oled.c文件中，将源代码的 void OLED_Refresh(void) 函数修改为图1.17.3.30样式。

//更新显存到OLED
void OLED_Refresh(void)
{
        u8 i,n;
        for(i=0;i<8;i++)
        {
                OLED_WR_Byte(0xb0+i,OLED_CMD); //设置行起始地址
                OLED_WR_Byte(0x00,OLED_CMD);   //设置低列起始地址
                OLED_WR_Byte(0x10,OLED_CMD);   //设置高列起始地址

                /* 等待I2C总线空闲 */
        while(i2c_flag_get(I2CX, I2C_FLAG_I2CBSY));

        /* 发送起始信号到I2C总线 */
        i2c_start_on_bus(I2CX);

        /* 等待发送起始信号成功标志位为1 */
        while(!i2c_flag_get(I2CX, I2C_FLAG_SBSEND));

        /* 发送从机地址到I2C总线 */
        i2c_master_addressing(I2CX, I2CX_SLAVE_ADDRESS7, I2C_TRANSMITTER);

        /* 等待发送从机地址成功标志位为1 */
        while(!i2c_flag_get(I2CX, I2C_FLAG_ADDSEND));
        /* 清除发送从机地址成功标志位 */
        i2c_flag_clear(I2CX,I2C_FLAG_ADDSEND);

        /* 等待传输数据缓冲区为空 */
        while( SET != i2c_flag_get(I2CX, I2C_FLAG_TBE));

        /* 发送寄存器地址（发送命令） */
        i2c_data_transmit(I2CX, 0x40);

        /* 等待字节传输完成位设置完成 */
        while(!i2c_flag_get(I2CX, I2C_FLAG_BTC));

        //发送全部显存数据
        for( n = 0; n < 128; n++ )
        {
            i2c_data_transmit(I2CX, OLED_GRAM[][]);
            while(!i2c_flag_get(I2CX, I2C_FLAG_BTC));
        }
        /* 向I2C总线发送停止信号 */
        i2c_stop_on_bus(I2CX);

        /* 等待直到停止信号发送完成  */
        while(I2C_CTL0(I2CX)&0x0200);
    }
}

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

移植验证

在main.c中输入代码如下

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

int main(void)
{
        nvic_priority_group_set(NVIC_PRIGROUP_PRE2_SUB2);  // 优先级分组
        board_init();
        OLED_Init();                                //初始化OLED
        OLED_Clear();
        OLED_Refresh();
        while(1)
        {
                OLED_ShowString(0,0,(uint8_t *)"ABC",8,1);//6*8 “ABC”
                OLED_ShowString(10,8,(uint8_t *)"ABC",12,1);//6*12 “ABC”
                OLED_ShowString(20,18,(uint8_t *)"ABC",16,1);//8*16 “ABC”
                OLED_ShowString(60,36,(uint8_t *)"ABC",24,1);//12*24 “ABC”
                OLED_Refresh();
                delay_ms(500);
        }
}

1

上电效果：

软硬件IIC二合一移植成功案例：

代码下载

链接在开发板介绍章节的资料下载！！

【标准库】模块移植手册

显示类

传感器类

无线通信类

控制类

显示类

传感器类

无线通信类

控制类

显示类

传感器类

无线通信类

控制类

0.91寸彩屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件IIC移植

硬件IIC移植

移植验证

0.91寸彩屏 ​

模块来源 ​

规格参数 ​

移植过程 ​

查看资料 ​

移植至工程 ​

引脚选择 ​

软件IIC移植 ​

硬件IIC移植 ​

移植验证 ​

0.91寸彩屏

模块来源

规格参数

移植过程

查看资料

移植至工程

引脚选择

软件IIC移植

硬件IIC移植

移植验证