一模塊來源
模塊實物展示:
資料下載鏈接:https://pan.baidu.com/s/1U9r32qeS2jOANB0SNwtwnw
資料提取碼:8888
二規(guī)格參數(shù)
以下信息見廠家資料
工作電壓:3.3V
工作電流:15MA
模塊尺寸:27.3 x 27.8 MM
像素大?。?28(H) x 64(V)RGB
驅(qū)動芯片:SSD1306
管腳數(shù)量:7 Pin(2.54mm間距排針)
尺寸參數(shù)
三移植過程
3.1查看資料
我們的目標是將例程移植至立創(chuàng)·CW32F030C8T6開發(fā)板上。按照以下步驟,即可完成移植。
將源碼導入工程;
根據(jù)編譯報錯處進行粗改;
修改引腳配置;
修改時序配置;
移植驗證。
打開廠家資料例程(例程下載見網(wǎng)盤鏈接)。具體路徑見下圖。
3.2移植至工程
將廠家資料路徑下的【OLED】文件夾,復制到自己的工程中。自己的工程至少需要有毫秒級延時函數(shù)。(工程可以參考入門手冊)
打開自己的工程,將我們剛剛復制過來的文件導入.c和.h文件。
然后我們在 oled.h 中添加如下宏定義,將sys.h改為board.h
然后我們將 oled.c 文件中的 #include "delay.h" 注釋掉。
3.3引腳選擇
該屏幕需要設置7個接口,具體接口說明見下表。
模塊為SPI通信協(xié)議的從機,D0為SPI信號線(SCK),D1為SPI輸出線(MOSI),CS為SPI片選線(NSS)。 下面分為軟件SPI移植與硬件SPI移植進行講解。
3.3.1軟件SPI移植
當前廠家源碼使用的是軟件SPI接口,SPI時序部分廠家已經(jīng)完成,我們只需要將引腳和延時配置好即可。所以對應接入的屏幕引腳請按照你的需要。這里選擇的引腳見下表。
選擇好引腳后,進入工程開始編寫屏幕引腳初始化代碼。 將oled.c源代碼中的 void OLED_Init(void) 修改為如下代碼。
//OLED的初始化
void OLED_Init(void)
{
GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結構體
__RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA時鐘
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端口定義 宏,進行修改,修改為下圖中右圖的樣式。
//-----------------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é)進行移植驗證。
源端口定義
修改后端口定義
到這里軟件SPI就移植完成了,請移步到第4節(jié)進行移植驗證。
3.3.2硬件SPI移植
硬件SPI與軟件SPI相比,硬件SPI是靠硬件上面的SPI控制器,所有的時鐘邊緣采樣,時鐘發(fā)生,還有時序控制,都是由硬件完成的。它降低了CPU的使用率,提高了運行速度。軟件SPI就是用代碼控制IO輸出高低電平,模擬SPI的時序,這種方法通信速度較慢,且不可靠。
想要使用硬件SPI驅(qū)動屏幕,需要確定使用的引腳是否有SPI外設功能??梢酝ㄟ^數(shù)據(jù)手冊進行查看。
說明
數(shù)據(jù)手冊和用戶手冊都在百度網(wǎng)盤資料,網(wǎng)盤地址看入門手冊。
當前使用的是硬件SPI接口,而屏幕我們只需要控制它,而不需要讀取屏幕的數(shù)據(jù),故使用的是3線的SPI,只使用到了時鐘線SCK、主機輸出從機輸入線MOSI和軟件控制的片選線NSS。而NSS我們使用的是軟件控制,所以除了SCL(SCK)/SDA(MOSI)引腳需要使用硬件SPI功能的引腳外,其他引腳都可以使用開發(fā)板上其他的GPIO。這里選擇使用PA5/PA7的SPI復用功能。其他對應接入的屏幕引腳請按照你的需要。這里選擇的引腳見表硬件SPI接線.
選擇好引腳后,進入工程開始編寫屏幕引腳初始化代碼。
引腳初始化配置見如下代碼。
//OLED的初始化
void OLED_Init(void)
{
GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結構體
__RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA時鐘
__RCC_SPI1_CLK_ENABLE(); // 使能SPI1時鐘
// GPIO復用為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 初始化結構體
SPI_InitStructure.SPI_Direction = SPI_Direction_2Lines_FullDuplex; // 雙線全雙工
SPI_InitStructure.SPI_Mode = SPI_Mode_Master; // 主機模式
SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; // 幀數(shù)據(jù)長度為8bit
SPI_InitStructure.SPI_CPOL = SPI_CPOL_High; // 時鐘空閑電平為高
SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge; // 第二個邊沿采樣
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端口定義 宏,修改為下方兩個圖中右圖的樣式。
//-----------------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,時序是由廠家編寫完成的。我們使用硬件SPI則需要對其進行修改。
在oled.c文件中,將源代碼的?void OLED_WR_Byte(u8 dat,u8 cmd)?函數(shù)修改為下方兩個圖中右圖的樣式。
源代碼格式
修改后的代碼
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); // 返回數(shù)據(jù)
OLED_CS_Set();
OLED_DC_Set();
}
到這里硬件SPI就移植完成了,請移步到4節(jié)進行移植驗證。
四移植驗證
在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