一、模塊來(lái)源

模塊實(shí)物展示：

資料下載鏈接：https://pan.baidu.com/s/1xy2zH8-hs-S8-_AcVtBP_g
資料提取碼：0jhj

二、規(guī)格參數(shù)

工作電壓：3.3V

工作電流：9MA

模塊尺寸：27.3 x 27.8 MM

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

驅(qū)動(dòng)芯片：SSD1306

通信協(xié)議：IIC

管腳數(shù)量：4 Pin（2.54mm間距排針）

以上信息見(jiàn)廠家資料文件

文件路徑

尺寸參數(shù)

三、移植過(guò)程

我們的目標(biāo)是將例程移植至立創(chuàng)·CW32F030C8T6開(kāi)發(fā)板上。按照以下步驟，即可完成移植。

將源碼導(dǎo)入工程；

根據(jù)編譯報(bào)錯(cuò)處進(jìn)行粗改；

修改引腳配置；

修改時(shí)序配置；

移植驗(yàn)證。

3.1查看資料

打開(kāi)廠家資料例程（例程下載見(jiàn)百度網(wǎng)盤(pán)鏈接下載）。具體路徑見(jiàn)例程路徑

例程路徑

3.2移植至工程

將廠家資料路徑下的【LCD】文件夾，復(fù)制到自己的工程中。（工程可以參考入門(mén)手冊(cè)工程模板）

復(fù)制示意圖

我們打開(kāi)工程文件，將我們剛剛復(fù)制到文件夾中的文件，導(dǎo)入C文件和路徑。

將 oled.h 文件下的 sys.h 改為 board.h。

修改oled.h頭文件

將 oled.c 文件下的 delay.h 注釋掉。

修改oled.c文件

在oled.h文件中定義三個(gè)宏，u8、u16、u32。

#ifndef u8
#define u8 uint8_t
#endif

#ifndef u16
#define u16 uint16_t
#endif

#ifndef u32
#define u32 uint32_t
#endif

3.3. 引腳選擇?

該屏幕需要設(shè)置4個(gè)接口，具體接口說(shuō)明見(jiàn) 各引腳說(shuō)明。

模塊為IIC通信協(xié)議的從機(jī)，SCL為IIC信號(hào)線，SDA為IIC數(shù)據(jù)線。

3.4. 軟件I2C移植?

當(dāng)前廠家源碼使用的是軟件IIC接口，IIC時(shí)序部分廠家已經(jīng)完成，我們只需要將引腳和延時(shí)配置好即可。所以對(duì)應(yīng)接入的屏幕引腳請(qǐng)按照你的需要。這里選擇的引腳見(jiàn)下圖。

選擇好引腳后，進(jìn)入工程開(kāi)始編寫(xiě)屏幕引腳初始化代碼。

在oled.h中定義LCD端口移植宏

//-----------------OLED端口引腳移植定義----------------

#define OLED_RCC_ENABLE()        __RCC_GPIOB_CLK_ENABLE()

#define OLED_GPIO_PORT           CW_GPIOB

#define OLED_SCL_PIN             GPIO_PIN_10
#define OLED_SDA_PIN             GPIO_PIN_11

將oled.c源代碼中的 void OLED_Init(void) 修改為如下代碼。

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

    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB,ENABLE);//使能GPIO時(shí)鐘

    //GPIO初始化設(shè)置
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10|GPIO_Pin_11;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;//推挽輸出模式
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;//100MHz
    GPIO_Init(GPIOB, &GPIO_InitStructure);//初始化

    delay_ms(200);

    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端口定義 宏。進(jìn)行修改！

//-----------------OLED端口定義----------------

#define OLED_SCL_Clr() GPIO_WritePin(OLED_GPIO_PORT,OLED_SCL_PIN,GPIO_Pin_RESET)//SCL
#define OLED_SCL_Set() GPIO_WritePin(OLED_GPIO_PORT,OLED_SCL_PIN,GPIO_Pin_SET)

#define OLED_SDA_Clr() GPIO_WritePin(OLED_GPIO_PORT,OLED_SDA_PIN,GPIO_Pin_RESET)//SDA
#define OLED_SDA_Set() GPIO_WritePin(OLED_GPIO_PORT,OLED_SDA_PIN,GPIO_Pin_SET)

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

原來(lái)端口定義

修改后端口定義

打開(kāi)oled.c文件 找到 void IIC_delay(void) 函數(shù)，將里面的內(nèi)容替換為

/**********************************************************
 * 函 數(shù) 名 稱(chēng)：IIC_delay
 * 函 數(shù) 功 能：延時(shí)
 * 傳 入 參 數(shù)：無(wú)
 * 函 數(shù) 返 回：無(wú)
 * 作       者：www.lckfb.com
 * 備       注：
**********************************************************/
void IIC_delay(void)
{
        delay_us(5);
}

四. 移植驗(yàn)證?

在main.c中輸入代碼如下

/*
 * 立創(chuàng)開(kāi)發(fā)板軟硬件資料與相關(guān)擴(kuò)展板軟硬件資料官網(wǎng)全部開(kāi)源
 * 開(kāi)發(fā)板官網(wǎng)：www.lckfb.com
 * 技術(shù)支持常駐論壇，任何技術(shù)問(wèn)題歡迎隨時(shí)交流學(xué)習(xí)
 * 立創(chuàng)論壇：https://oshwhub.com/forum
 * 關(guān)注bilibili賬號(hào)：【立創(chuàng)開(kāi)發(fā)板】，掌握我們的最新動(dòng)態(tài)！
 * 不靠賣(mài)板賺錢(qián)，以培養(yǎng)中國(guó)工程師為己任
 * Change Logs:
 * Date           Author       Notes
 * 2024-06-18     LCKFB-LP    first version
 */
#include "board.h"
#include "stdio.h"
#include "bsp_uart.h"
#include "oled.h"

int32_t main(void)
{
    board_init();        // 開(kāi)發(fā)板初始化

    uart1_init(115200);        // 串口1波特率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(100);

    }
}

上電效果：

模塊移植成功案例代碼：

鏈接：https://pan.baidu.com/s/1YnMyfuDg7ax4LpDQ028dWQ?pwd=LCKF 提取碼：LCKF