一、模塊來源

模塊實(shí)物展示：

資料下載鏈接：https://pan.baidu.com/s/1U9r32qeS2jOANB0SNwtwnw
資料提取碼：8888

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

以下信息見廠家資料

工作電壓：3.3V

工作電流：15MA

模塊尺寸：27.3 x 27.8 MM

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

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

通信協(xié)議：SPI

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

尺寸參數(shù)

三、移植過程

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

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

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

修改引腳配置；

修改時(shí)序配置；

移植驗(yàn)證。

3.1查看資料

打開廠家資料例程（例程下載見網(wǎng)盤鏈接）。具體路徑見下圖。

3.2移植至工程

將廠家資料路徑下的【OLED】文件夾，復(fù)制到自己的工程中。自己的工程至少需要有毫秒級延時(shí)函數(shù)。（工程可以參考入門手冊）

打開自己的工程，將我們剛剛復(fù)制過來的文件導(dǎo)入.c和.h文件。

然后我們在 oled.h 中添加如下宏定義，將sys.h改為board.h

然后我們將 oled.c 文件中的 #include "delay.h" 注釋掉。

3.3引腳選擇

該屏幕需要設(shè)置7個(gè)接口，具體接口說明見下表。

模塊為SPI通信協(xié)議的從機(jī)，D0為SPI信號線（SCK），D1為SPI輸出線（MOSI），CS為SPI片選線（NSS）。 下面分為軟件SPI移植與硬件SPI移植進(jìn)行講解。

3.4 軟件SPI移植

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

選擇好引腳后，進(jìn)入工程開始編寫屏幕引腳初始化代碼。 將oled.c源代碼中的 void OLED_Init(void) 修改為如下代碼。

//OLED的初始化
void OLED_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化結(jié)構(gòu)體

    __RCC_GPIOA_CLK_ENABLE();           // 使能GPIOA時(shí)鐘

    GPIO_InitStruct.Pins =  OLED_SCL_PIN| // GPIO引腳
                            OLED_MOSI_PIN|
                            OLED_RES_PIN|
                            OLED_DC_PIN|
                            OLED_CS_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽輸出
    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 輸出速度高
    GPIO_Init(OLED_GPIO_PORT, &GPIO_InitStruct);   // 初始化

    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端口定義 宏，進(jìn)行修改，修改為下圖中右圖的樣式。

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

#define OLED_GPIO_PORT      CW_GPIOA

#define OLED_SCL_PIN        GPIO_PIN_5
#define OLED_MOSI_PIN       GPIO_PIN_7
#define OLED_RES_PIN        GPIO_PIN_3
#define OLED_DC_PIN         GPIO_PIN_2
#define OLED_CS_PIN         GPIO_PIN_4



#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_MOSI_PIN, GPIO_Pin_RESET)//SDA
#define OLED_SDA_Set() GPIO_WritePin(OLED_GPIO_PORT, OLED_MOSI_PIN, GPIO_Pin_SET)

#define OLED_RES_Clr() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_RESET)//RES
#define OLED_RES_Set() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_SET)

#define OLED_DC_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_RESET)//DC
#define OLED_DC_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_SET)

#define OLED_CS_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_RESET)//CS
#define OLED_CS_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_SET)

源端口定義

修改后端口定義

到這里軟件SPI就移植完成了，請移步到第4節(jié)進(jìn)行移植驗(yàn)證。

3.3.2 硬件SPI移植?

硬件SPI與軟件SPI相比，硬件SPI是靠硬件上面的SPI控制器，所有的時(shí)鐘邊緣采樣，時(shí)鐘發(fā)生，還有時(shí)序控制，都是由硬件完成的。它降低了CPU的使用率，提高了運(yùn)行速度。軟件SPI就是用代碼控制IO輸出高低電平，模擬SPI的時(shí)序，這種方法通信速度較慢，且不可靠。

想要使用硬件SPI驅(qū)動(dòng)屏幕，需要確定使用的引腳是否有SPI外設(shè)功能。可以通過數(shù)據(jù)手冊進(jìn)行查看。

說明
數(shù)據(jù)手冊和用戶手冊都在百度網(wǎng)盤資料，網(wǎng)盤地址看入門手冊。

當(dāng)前使用的是硬件SPI接口，而屏幕我們只需要控制它，而不需要讀取屏幕的數(shù)據(jù)，故使用的是3線的SPI，只使用到了時(shí)鐘線SCK、主機(jī)輸出從機(jī)輸入線MOSI和軟件控制的片選線NSS。而NSS我們使用的是軟件控制，所以除了SCL(SCK)/SDA(MOSI)引腳需要使用硬件SPI功能的引腳外，其他引腳都可以使用開發(fā)板上其他的GPIO。這里選擇使用PA5/PA7的SPI復(fù)用功能。其他對應(yīng)接入的屏幕引腳請按照你的需要。這里選擇的引腳見表硬件SPI接線.

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

引腳初始化配置見如下代碼。

//OLED的初始化
void OLED_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStruct;   // GPIO初始化結(jié)構(gòu)體

    __RCC_GPIOA_CLK_ENABLE();           // 使能GPIOA時(shí)鐘
    __RCC_SPI1_CLK_ENABLE();            // 使能SPI1時(shí)鐘

    // GPIO復(fù)用為SPI1
    SPI1_AF_SCK();
    SPI1_AF_MOSI();

    GPIO_InitStruct.Pins =  OLED_SCL_PIN| // GPIO引腳
                            OLED_MOSI_PIN|
                            OLED_RES_PIN|
                            OLED_DC_PIN|
                            OLED_CS_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;    // 推挽輸出
    GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;       // 輸出速度高
    GPIO_Init(OLED_GPIO_PORT, &GPIO_InitStruct);   // 初始化

    SPI_InitTypeDef  SPI_InitStructure; // SPI 初始化結(jié)構(gòu)體

    SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex;    // 雙線全雙工
    SPI_InitStructure.SPI_Mode = SPI_Mode_Master;                         // 主機(jī)模式
    SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b;                     // 幀數(shù)據(jù)長度為8bit
    SPI_InitStructure.SPI_CPOL = SPI_CPOL_High;                           // 時(shí)鐘空閑電平為高
    SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge;                          // 第二個(gè)邊沿采樣
    SPI_InitStructure.SPI_NSS = SPI_NSS_Soft;                             // 片選信號由SSI寄存器控制
    SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_8;    // 波特率為PCLK的8分頻
    SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB;                    // 最高有效位 MSB 收發(fā)在前
    SPI_InitStructure.SPI_Speed = SPI_Speed_Low;                          // 低速SPI

    SPI_Init(BSP_SPI1, &SPI_InitStructure);   // 初始化
    SPI_Cmd(BSP_SPI1, ENABLE); // 使能SPI1


    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);
}

將oled.h中的 LCD端口定義 宏，修改為下方兩個(gè)圖中右圖的樣式。

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

#define BSP_SPI1               CW_SPI1

//GPIO AF
#define SPI1_AF_SCK()          PA05_AFx_SPI1SCK()
#define SPI1_AF_MOSI()         PA07_AFx_SPI1MOSI()

#define OLED_GPIO_PORT         CW_GPIOA

#define OLED_SCL_PIN           GPIO_PIN_5
#define OLED_MOSI_PIN          GPIO_PIN_7
#define OLED_RES_PIN           GPIO_PIN_3
#define OLED_DC_PIN            GPIO_PIN_2
#define OLED_CS_PIN            GPIO_PIN_4


#define OLED_RES_Clr() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_RESET)//RES
#define OLED_RES_Set() GPIO_WritePin(OLED_GPIO_PORT, OLED_RES_PIN, GPIO_Pin_SET)

#define OLED_DC_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_RESET)//DC
#define OLED_DC_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_DC_PIN, GPIO_Pin_SET)

#define OLED_CS_Clr()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_RESET)//CS
#define OLED_CS_Set()  GPIO_WritePin(OLED_GPIO_PORT, OLED_CS_PIN, GPIO_Pin_SET)

源端口定義

修改后端口定義

初始化部分完，還需要修改發(fā)送數(shù)據(jù)部分。源代碼中使用的是軟件SPI，時(shí)序是由廠家編寫完成的。我們使用硬件SPI則需要對其進(jìn)行修改。

在oled.c文件中，將源代碼的 void OLED_WR_Byte(u8 dat,u8 cmd) 函數(shù)修改為下方兩個(gè)圖中右圖的樣式。

源代碼格式

修改后的代碼

void OLED_WR_Byte(u8 dat,u8 cmd)
{
    if(cmd)
      OLED_DC_Set();
    else
      OLED_DC_Clr();

    OLED_CS_Clr();

    while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_TXE) == RESET);

    SPI_SendData(BSP_SPI1, dat); // 發(fā)送數(shù)據(jù)

    while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_RXNE) == RESET);

    uint16_t temp = SPI_ReceiveData(BSP_SPI1); // 返回?cái)?shù)據(jù)

    OLED_CS_Set();
    OLED_DC_Set();
}

到這里硬件SPI就移植完成了，請移步到4節(jié)進(jìn)行移植驗(yàn)證。

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

在main.c中輸入代碼如下

/*
 * 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();        // 開發(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(500);
    }
}

上電效果：

移植成功代碼（軟件和硬件SPI）：

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