一、模塊來(lái)源
產(chǎn)品實(shí)物展示:
?
資料下載鏈接:https://pan.baidu.com/s/1FNGHM0u5MQ2li3QOrTkTuA
資料提取碼:8888
二、規(guī)格參數(shù)
以下信息見(jiàn)廠家資料屏幕規(guī)格書(shū)。
工作電壓:3.3V ~ 5V
工作電流:20mA
模塊尺寸:33.5 x 35.4 MM
像素間距:0.23(H) x 0.23(V)
像素尺寸:0.21(H) x 0.21(V)
驅(qū)動(dòng)芯片:SH1106
通信協(xié)議:SPI(可調(diào)IIC)
三、移植過(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移植至工程
將廠家資料路徑下的【OLED】文件夾,復(fù)制到自己的工程中。自己的工程至少需要有毫秒級(jí)延時(shí)函數(shù)。(工程可以參考空白工程下載)
打開(kāi)自己的工程,將我們剛剛復(fù)制過(guò)來(lái)的文件導(dǎo)入.c和.h文件。
https://wiki.lckfb.com/zh-hans/dwx-cw32f030c8t6/module/screen/1-3-single-screen.html(跳轉(zhuǎn)原文查看)
將oled.h文件下的 sys.h 改為 board.h。
將oled.c文件下的 delay.h 注釋掉。
3.3引腳選擇
該屏幕需要設(shè)置8個(gè)接口,具體接口說(shuō)明見(jiàn)下表各引腳說(shuō)明。
模塊為SPI通信協(xié)議的從機(jī),SCL為SPI信號(hào)線(SCK),SDA為SPI輸出線(MOSI),CS為SPI片選線(NSS)。
如果MCU的GPIO引腳不足,可以將屏幕的兩個(gè)引腳接口不接入MCU的GPIO。
將RES接入MCU的復(fù)位引腳,當(dāng)MCU復(fù)位時(shí),屏幕也跟著復(fù)位;
下面分為軟件SPI移植與硬件SPI移植進(jìn)行講解。
3.4軟件SPI移植
當(dāng)前廠家源碼使用的是軟件SPI接口,SPI時(shí)序部分廠家已經(jīng)完成,我們只需要將引腳和延時(shí)配置好即可。所以對(duì)應(yīng)接入的屏幕引腳請(qǐng)按照你的需要。這里選擇的引腳見(jiàn)下表.
在oled.h中添加OLED的引腳移植定義
//-----------------OLED端口移植定義---------------- #define OLED_RCC_GPIO_ENABLE() __RCC_GPIOA_CLK_ENABLE() #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
選擇好引腳后,進(jìn)入工程開(kāi)始編寫(xiě)屏幕引腳初始化代碼。 將oled.c源代碼中的void OLED_Init(void)修改為如下代碼。
//OLED的初始化 void OLED_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結(jié)構(gòu)體 OLED_RCC_GPIO_ENABLE(); // 使能GPIO時(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); /*display off*/ OLED_WR_Byte(0x02,OLED_CMD); /*set lower column address*/ OLED_WR_Byte(0x10,OLED_CMD); /*set higher column address*/ OLED_WR_Byte(0x40,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(0xcf,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(0x3F,OLED_CMD); /*duty = 1/64*/ OLED_WR_Byte(0xad,OLED_CMD); /*set charge pump enable*/ OLED_WR_Byte(0x8b,OLED_CMD); /* 0x8B 內(nèi)供 VCC */ OLED_WR_Byte(0x33,OLED_CMD); /*0X30---0X33 set VPP 9V */ OLED_WR_Byte(0xC8,OLED_CMD); /*Com scan direction*/ OLED_WR_Byte(0xD3,OLED_CMD); /*set display offset*/ OLED_WR_Byte(0x00,OLED_CMD); /* 0x20 */ 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); /*0x22*/ OLED_WR_Byte(0xDA,OLED_CMD); /*set COM pins*/ OLED_WR_Byte(0x12,OLED_CMD); OLED_WR_Byte(0xdb,OLED_CMD); /*set vcomh*/ OLED_WR_Byte(0x40,OLED_CMD); OLED_Clear(); OLED_WR_Byte(0xAF,OLED_CMD); /*display ON*/ }
將lcd_init.h中的 LCD端口定義 宏,修改為右圖樣式。
//-----------------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_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就移植完成了,請(qǐng)移步到第4節(jié)進(jìn)行移植驗(yàn)證。
3.5硬件SPI移植
硬件SPI與軟件SPI相比,硬件SPI是靠硬件上面的SPI控制器,所有的時(shí)鐘邊緣采樣,時(shí)鐘發(fā)生,還有時(shí)序控制,都是由硬件完成的。它降低了CPU的使用率,提高了運(yùn)行速度。軟件SPI就是用代碼控制IO輸出高低電平,模擬SPI的時(shí)序,這種方法通信速度較慢,且不可靠。
想要使用硬件SPI驅(qū)動(dòng)屏幕,需要確定使用的引腳是否有SPI外設(shè)功能??梢酝ㄟ^(guò)數(shù)據(jù)手冊(cè)進(jìn)行查看。
數(shù)據(jù)手冊(cè)和用戶手冊(cè)都在百度網(wǎng)盤(pán)資料,網(wǎng)盤(pán)地址看入門(mén)手冊(cè)。
當(dāng)前使用的是硬件SPI接口,而屏幕我們只需要控制它,而不需要讀取屏幕的數(shù)據(jù),故使用的是3線的SPI,只使用到了時(shí)鐘線SCK、主機(jī)輸出從機(jī)輸入線MOSI和軟件控制的片選線NSS。而NSS我們使用的是軟件控制,所以除了SCL(SCK)/SDA(MOSI)引腳需要使用硬件SPI功能的引腳外,其他引腳都可以使用開(kāi)發(fā)板上其他的GPIO。這里選擇使用PA5/PA7的SPI復(fù)用功能。其他對(duì)應(yīng)接入的屏幕引腳請(qǐng)按照你的需要。這里選擇的引腳見(jiàn)表硬件SPI接線
在oled.h中添加OLED的引腳移植定義
//-----------------OLED端口移植定義---------------- #define OLED_RCC_GPIO_ENABLE() __RCC_GPIOA_CLK_ENABLE() #define OLED_RCC_SPI1_ENABLE() __RCC_SPI1_CLK_ENABLE() //GPIO AF #define SPI1_AF_SCK() PA05_AFx_SPI1SCK() #define SPI1_AF_MOSI() PA07_AFx_SPI1MOSI() #define BSP_SPI1 CW_SPI1 #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
選擇好引腳后,進(jìn)入工程開(kāi)始編寫(xiě)屏幕引腳初始化代碼。
引腳初始化配置見(jiàn)如下代碼。
//OLED的初始化 void OLED_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結(jié)構(gòu)體 OLED_RCC_GPIO_ENABLE(); // 使能GPIO時(shí)鐘 OLED_RCC_SPI1_ENABLE(); // 使能SPI1時(shí)鐘 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ù)長(zhǎng)度為8bit SPI_InitStructure.SPI_CPOL = SPI_CPOL_High; // 時(shí)鐘空閑電平為高 SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge; // 第二個(gè)邊沿采樣 SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; // 片選信號(hào)由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); /*display off*/ OLED_WR_Byte(0x02,OLED_CMD); /*set lower column address*/ OLED_WR_Byte(0x10,OLED_CMD); /*set higher column address*/ OLED_WR_Byte(0x40,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(0xcf,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(0x3F,OLED_CMD); /*duty = 1/64*/ OLED_WR_Byte(0xad,OLED_CMD); /*set charge pump enable*/ OLED_WR_Byte(0x8b,OLED_CMD); /* 0x8B 內(nèi)供 VCC */ OLED_WR_Byte(0x33,OLED_CMD); /*0X30---0X33 set VPP 9V */ OLED_WR_Byte(0xC8,OLED_CMD); /*Com scan direction*/ OLED_WR_Byte(0xD3,OLED_CMD); /*set display offset*/ OLED_WR_Byte(0x00,OLED_CMD); /* 0x20 */ 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); /*0x22*/ OLED_WR_Byte(0xDA,OLED_CMD); /*set COM pins*/ OLED_WR_Byte(0x12,OLED_CMD); OLED_WR_Byte(0xdb,OLED_CMD); /*set vcomh*/ OLED_WR_Byte(0x40,OLED_CMD); OLED_Clear(); OLED_WR_Byte(0xAF,OLED_CMD); /*display ON*/ }
將oled.h中的 LCD端口定義 宏,修改為右圖樣式。
//-----------------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_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)
初始化部分完,還需要修改發(fā)送數(shù)據(jù)部分。源代碼中使用的是軟件SPI,時(shí)序是由廠家編寫(xiě)完成的。我們使用硬件SPI則需要對(duì)其進(jìn)行修改。 在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); // 返回?cái)?shù)據(jù) OLED_CS_Set(); OLED_DC_Set(); }
到這里硬件SPI就移植完成了,請(qǐng)移步到4節(jié)進(jìn)行移植驗(yàn)證。
四、移植驗(yàn)證
在main.c中輸入代碼如下
* Change Logs: * Date Author Notes * 2024-06-19 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(); uint32_t t = 0; 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_ShowString(50,8,(uint8_t *)"Num:",16,1);//12*24 “ABC” OLED_ShowNum(90,8,t,3,16,1); t += 1; OLED_Refresh(); delay_ms(1000); } }
上電效果:
移植成功案例代碼:?
鏈接:https://pan.baidu.com/s/1t08db9FJIMY00ys3gNvPag?pwd=LCKF
提取碼:LCKF
?
審核編輯 黃宇
-
OLED屏幕
+關(guān)注
關(guān)注
3文章
207瀏覽量
28508 -
CW32
+關(guān)注
關(guān)注
1文章
255瀏覽量
1204
發(fā)布評(píng)論請(qǐng)先 登錄
CW32模塊使用 1.28寸圓屏LCD彩色顯示屏

【CW32模塊使用】0.96寸IIC單色屏

【CW32模塊使用】0.96寸SPI單色屏

天馬攜手康寧推出最新柔性OLED車(chē)載顯示屏
三星顯示在CES 2025上展示全球最大可折疊OLED顯示屏


小尺寸單色LCD液晶顯示屏12832圖形點(diǎn)陣 低功耗128*32點(diǎn)陣COG顯示模塊

COG13264圖形點(diǎn)陣液晶屏,低功耗,F(xiàn)PC插接,SPI串口通訊,3.3V供電 2.4寸單色液晶顯示屏

128*64點(diǎn)陣工業(yè)串口屏 2.8寸高品質(zhì)單色顯示屏防靜電抗干擾性能強(qiáng)

oled是什么顯示屏 OLED與LCD的區(qū)別
oled顯示屏的優(yōu)缺點(diǎn)有哪些
P2.5LED顯示屏好還是P3LED顯示屏好?
OLED柔性顯示屏的金線封裝膠

評(píng)論