一、模塊來源
產品實物展示:
?
資料下載鏈接:https://pan.baidu.com/s/1FNGHM0u5MQ2li3QOrTkTuA
資料提取碼:8888
二、規格參數
以下信息見廠家資料屏幕規格書。
工作電壓:3.3V ~ 5V
工作電流:20mA
模塊尺寸:33.5 x 35.4 MM
像素間距:0.23(H) x 0.23(V)
像素尺寸:0.21(H) x 0.21(V)
驅動芯片:SH1106
通信協議:SPI(可調IIC)
三、移植過程
我們的目標是將例程移植至立創·CW32F030C8T6開發板上。按照以下步驟,即可完成移植。
將源碼導入工程;
根據編譯報錯處進行粗改;
修改引腳配置;
修改時序配置;
移植驗證。
3.1查看資料
打開廠家資料例程(例程下載見 百度網盤鏈接)。具體路徑見 例程路徑。
3.2移植至工程
將廠家資料路徑下的【OLED】文件夾,復制到自己的工程中。自己的工程至少需要有毫秒級延時函數。(工程可以參考空白工程下載)
打開自己的工程,將我們剛剛復制過來的文件導入.c和.h文件。
https://wiki.lckfb.com/zh-hans/dwx-cw32f030c8t6/module/screen/1-3-single-screen.html(跳轉原文查看)
將oled.h文件下的 sys.h 改為 board.h。
將oled.c文件下的 delay.h 注釋掉。
3.3引腳選擇
該屏幕需要設置8個接口,具體接口說明見下表各引腳說明。
模塊為SPI通信協議的從機,SCL為SPI信號線(SCK),SDA為SPI輸出線(MOSI),CS為SPI片選線(NSS)。
如果MCU的GPIO引腳不足,可以將屏幕的兩個引腳接口不接入MCU的GPIO。
將RES接入MCU的復位引腳,當MCU復位時,屏幕也跟著復位;
下面分為軟件SPI移植與硬件SPI移植進行講解。
3.4軟件SPI移植
當前廠家源碼使用的是軟件SPI接口,SPI時序部分廠家已經完成,我們只需要將引腳和延時配置好即可。所以對應接入的屏幕引腳請按照你的需要。這里選擇的引腳見下表.
在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
選擇好引腳后,進入工程開始編寫屏幕引腳初始化代碼。 將oled.c源代碼中的void OLED_Init(void)修改為如下代碼。
//OLED的初始化 void OLED_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結構體 OLED_RCC_GPIO_ENABLE(); // 使能GPIO時鐘 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 內供 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就移植完成了,請移步到第4節進行移植驗證。
3.5硬件SPI移植
硬件SPI與軟件SPI相比,硬件SPI是靠硬件上面的SPI控制器,所有的時鐘邊緣采樣,時鐘發生,還有時序控制,都是由硬件完成的。它降低了CPU的使用率,提高了運行速度。軟件SPI就是用代碼控制IO輸出高低電平,模擬SPI的時序,這種方法通信速度較慢,且不可靠。
想要使用硬件SPI驅動屏幕,需要確定使用的引腳是否有SPI外設功能??梢酝ㄟ^數據手冊進行查看。
數據手冊和用戶手冊都在百度網盤資料,網盤地址看入門手冊。
當前使用的是硬件SPI接口,而屏幕我們只需要控制它,而不需要讀取屏幕的數據,故使用的是3線的SPI,只使用到了時鐘線SCK、主機輸出從機輸入線MOSI和軟件控制的片選線NSS。而NSS我們使用的是軟件控制,所以除了SCL(SCK)/SDA(MOSI)引腳需要使用硬件SPI功能的引腳外,其他引腳都可以使用開發板上其他的GPIO。這里選擇使用PA5/PA7的SPI復用功能。其他對應接入的屏幕引腳請按照你的需要。這里選擇的引腳見表硬件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
選擇好引腳后,進入工程開始編寫屏幕引腳初始化代碼。
引腳初始化配置見如下代碼。
//OLED的初始化 void OLED_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結構體 OLED_RCC_GPIO_ENABLE(); // 使能GPIO時鐘 OLED_RCC_SPI1_ENABLE(); // 使能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; // 幀數據長度為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 收發在前 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 內供 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)
初始化部分完,還需要修改發送數據部分。源代碼中使用的是軟件SPI,時序是由廠家編寫完成的。我們使用硬件SPI則需要對其進行修改。 在oled.c文件中,將源代碼的void OLED_WR_Byte(u8 dat,u8 cmd)函數修改為右圖樣式。
源代碼格式
修改后的代碼
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); // 發送數據 while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_RXNE) == RESET); uint16_t temp = SPI_ReceiveData(BSP_SPI1); // 返回數據 OLED_CS_Set(); OLED_DC_Set(); }
到這里硬件SPI就移植完成了,請移步到4節進行移植驗證。
四、移植驗證
在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(); // 開發板初始化 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屏幕
+關注
關注
3文章
207瀏覽量
28521 -
CW32
+關注
關注
1文章
255瀏覽量
1211
發布評論請先 登錄
CW32模塊使用 1.28寸圓屏LCD彩色顯示屏

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

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

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





評論