一、模塊來源
產品實物展示:
資料下載鏈接:https://pan.baidu.com/s/18tt2PzcnTvqTRubdRy2yoQ
資料提取碼:8888
二、規格參數
以下信息見廠家資料屏幕規格書(百度網盤鏈接下載)
工作電壓:2.4V-3.3V
工作電流:40MA
模塊尺寸:27.78(H) x 39.22(V) MM
像素大小:240(H) x 240(V)RGB
驅動芯片:ST7789V2
通信協議:SPI
工作電流:40MA
模塊尺寸:27.78(H) x 39.22(V) MM
像素大?。?/strong>240(H) x 240(V)RGB
驅動芯片:ST7789V2
通信協議:SPI
三、移植過程
我們的目標是將例程移植至立創·CW32F030C8T6開發板上。按照以下步驟,即可完成移植。
將源碼導入工程;
根據編譯報錯處進行粗改;
修改引腳配置;
修改時序配置;
移植驗證。
3.1查看資料
打開廠家資料例程(例程下載見下載鏈接)。具體路徑見例程路徑
我們主要修改的是引腳的初始化與時序的延時修改。
3.2移植至工程
將廠家資料路徑下的【LCD】文件夾,復制到自己的工程中。自己的工程至少需要有毫秒級延時函數。(工程可以參考入門手冊工程模板)
打開自己的工程,將我們剛剛復制過來的文件導入.c和.h文件。
https://wiki.lckfb.com/zh-hans/dwx-cw32f030c8t6/module/screen/1-3-color-screen.html(跳轉原文查看)
將lcd_init.h文件下的 sys.h 改為 board.h,還要將lcd.h文件下的 sys.h 改為 board.h。
(在左邊將lcd.c和lcd_init.c的工程目錄展開,就發現有lcd_init.h和lcd.h)
將 lcd.c 和 lcd_init.c 文件中的 delay.h 注釋掉!!
分別在lcd_init.h與lcd.h文件中定義三個宏,u32、u16與u8。
#ifndef u8 #define u8 uint8_t #endif #ifndef u16 #define u16 uint16_t #endif #ifndef u32 #define u32 uint32_t #endif
將touch.c、lcd.c、GUI.c與test.c文件中的頭文件delay.h 注釋掉!!
3.3引腳選擇
該屏幕需要設置10個接口。
模塊為SPI通信協議的從機,SCL為SPI信號線(SCK),SDA為SPI輸出線(MOSI),CS為SPI片選線(NSS)。
說明
如果MCU的GPIO引腳不足,可以將屏幕的兩個引腳接口不接入MCU的GPIO。
將RES接入MCU的復位引腳,當MCU復位時,屏幕也跟著復位;
可以將BLK接入3.3V或懸空,代價是無法控制背光亮度。
下面分為軟件SPI移植與硬件SPI移植進行講解。
3.4軟件SPI移植
當前廠家源碼使用的是軟件SPI接口,SPI時序部分廠家已經完成,我們只需要將引腳和延時配置好即可。所以對應接入的屏幕引腳請按照你的需要。這里選擇的引腳見軟件SPI接線
選擇好引腳后,進入工程開始編寫屏幕引腳初始化代碼。
為了方便后續移植,我在lcd_init.h處宏定義了每一個引腳,后續根據需要進行修改即可。
//-----------------LCD端口移植---------------- #define RCC_LCD_ENABLE() __RCC_GPIOA_CLK_ENABLE() #define RCC_SPI1_ENABLE() __RCC_SPI1_CLK_ENABLE() #define PORT_LCD CW_GPIOA //SCL #define GPIO_LCD_SCL GPIO_PIN_5 //SDA #define GPIO_LCD_SDA GPIO_PIN_7 //CS1 #define GPIO_LCD_CS GPIO_PIN_4 //DC #define GPIO_LCD_DC GPIO_PIN_2 //RES #define GPIO_LCD_RES GPIO_PIN_3 //BLK #define GPIO_LCD_BLK GPIO_PIN_0 //FSO #define GPIO_LCD_FSO GPIO_PIN_6 //CS2 #define GPIO_LCD_CS2 GPIO_PIN_1
將lcd_init.c源代碼中的void LCD_GPIO_Init(void)修改為如下代碼。
void LCD_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結構體 RCC_LCD_ENABLE(); // 使能GPIO時鐘 GPIO_InitStruct.Pins = GPIO_LCD_SCL| // GPIO引腳 GPIO_LCD_SDA| GPIO_LCD_CS| GPIO_LCD_DC| GPIO_LCD_RES| GPIO_LCD_BLK| GPIO_LCD_CS2; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽輸出 GPIO_InitStruct.Speed = GPIO_SPEED_HIGH; // 輸出速度高 GPIO_Init(PORT_LCD, &GPIO_InitStruct); // 初始化 GPIO_InitStruct.Pins = GPIO_LCD_FSO; // GPIO引腳 GPIO_InitStruct.Mode = GPIO_MODE_INPUT_PULLUP; // 上拉輸入 GPIO_Init(PORT_LCD, &GPIO_InitStruct); // 初始化 }
將lcd_init.h中的 LCD端口定義 宏,修改為:
//-----------------LCD端口定義---------------- #define LCD_SCLK_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_SCL,GPIO_Pin_RESET)//SCL=SCLK #define LCD_SCLK_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_SCL,GPIO_Pin_SET) #define LCD_MOSI_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_SDA,GPIO_Pin_RESET)//SDA=MOSI #define LCD_MOSI_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_SDA,GPIO_Pin_SET) #define LCD_RES_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_RES,GPIO_Pin_RESET)//RES #define LCD_RES_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_RES,GPIO_Pin_SET) #define LCD_DC_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_DC,GPIO_Pin_RESET)//DC #define LCD_DC_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_DC,GPIO_Pin_SET) #define LCD_CS_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS,GPIO_Pin_RESET)//CS1 #define LCD_CS_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS,GPIO_Pin_SET) #define LCD_BLK_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_BLK,GPIO_Pin_RESET)//BLK #define LCD_BLK_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_BLK,GPIO_Pin_SET) #define ZK_MISO GPIO_ReadPin(PORT_LCD,GPIO_LCD_FSO)//MISO 讀取字庫數據引腳 #define ZK_CS_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS2,GPIO_Pin_RESET)//CS2 字庫片選 #define ZK_CS_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS2,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/PA6/PA7的SPI復用功能。其他對應接入的屏幕引腳請按照你的需要。這里選擇的引腳見表硬件SPI接線
有SPI功能的引腳
選擇好引腳后,進入工程開始編寫屏幕引腳初始化代碼。
為了方便后續移植,我在lcd_init.h處宏定義了每一個引腳,后續根據需要進行修改即可。
//-----------------LCD端口移植---------------- #define RCC_LCD_ENABLE() __RCC_GPIOA_CLK_ENABLE() #define RCC_SPI1_ENABLE() __RCC_SPI1_CLK_ENABLE() #define BSP_SPI1 CW_SPI1 //GPIO AF #define SPI1_AF_SCK() PA05_AFx_SPI1SCK() #define SPI1_AF_MOSI() PA07_AFx_SPI1MOSI() #define SPI1_AF_MISO() PA06_AFx_SPI1MISO() #define PORT_LCD CW_GPIOA //SCL #define GPIO_LCD_SCL GPIO_PIN_5 //SDA #define GPIO_LCD_SDA GPIO_PIN_7 //CS1 #define GPIO_LCD_CS GPIO_PIN_4 //DC #define GPIO_LCD_DC GPIO_PIN_2 //RES #define GPIO_LCD_RES GPIO_PIN_3 //BLK #define GPIO_LCD_BLK GPIO_PIN_0 //FSO #define GPIO_LCD_FSO GPIO_PIN_6 //CS2 #define GPIO_LCD_CS2 GPIO_PIN_1
引腳初始化配置見如下代碼。
void LCD_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結構體 RCC_LCD_ENABLE(); // 使能GPIO時鐘 RCC_SPI1_ENABLE(); // 使能SPI1時鐘 // GPIO復用為SPI1 SPI1_AF_SCK(); SPI1_AF_MOSI(); SPI1_AF_MISO(); GPIO_InitStruct.Pins = GPIO_LCD_SCL| // GPIO引腳 GPIO_LCD_SDA| GPIO_LCD_CS| GPIO_LCD_DC| GPIO_LCD_RES| GPIO_LCD_BLK| GPIO_LCD_CS2; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽輸出 GPIO_InitStruct.Speed = GPIO_SPEED_HIGH; // 輸出速度高 GPIO_Init(PORT_LCD, &GPIO_InitStruct); // 初始化 GPIO_InitStruct.Pins = GPIO_LCD_FSO; // GPIO引腳 GPIO_InitStruct.Mode = GPIO_MODE_INPUT_PULLUP; // 上拉輸入 GPIO_Init(PORT_LCD, &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 }
將lcd_init.h中的 LCD端口定義 宏,修改為:
//-----------------LCD端口定義---------------- #define LCD_SCLK_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_SCL,GPIO_Pin_RESET)//SCL=SCLK #define LCD_SCLK_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_SCL,GPIO_Pin_SET) #define LCD_MOSI_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_SDA,GPIO_Pin_RESET)//SDA=MOSI #define LCD_MOSI_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_SDA,GPIO_Pin_SET) #define LCD_RES_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_RES,GPIO_Pin_RESET)//RES #define LCD_RES_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_RES,GPIO_Pin_SET) #define LCD_DC_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_DC,GPIO_Pin_RESET)//DC #define LCD_DC_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_DC,GPIO_Pin_SET) #define LCD_CS_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS,GPIO_Pin_RESET)//CS1 #define LCD_CS_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS,GPIO_Pin_SET) #define LCD_BLK_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_BLK,GPIO_Pin_RESET)//BLK #define LCD_BLK_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_BLK,GPIO_Pin_SET) #define ZK_MISO GPIO_ReadPin(PORT_LCD,GPIO_LCD_FSO)//MISO 讀取字庫數據引腳 #define ZK_CS_Clr() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS2,GPIO_Pin_RESET)//CS2 字庫片選 #define ZK_CS_Set() GPIO_WritePin(PORT_LCD,GPIO_LCD_CS2,GPIO_Pin_SET)

源端口定義
修改后端口定義
初始化部分完,還需要修改發送數據部分。源代碼中使用的是軟件SPI,時序是由廠家編寫完成的。我們使用硬件SPI則需要對其進行修改。
在lcd_init.c文件中,將源代碼的void LCD_Writ_Bus(u8 dat) 函數修改為:
源代碼格式
修改后的代碼
/****************************************************************************** 函數說明:LCD串行數據寫入函數 入口數據:dat 要寫入的串行數據 返回值: 無 ******************************************************************************/ void LCD_Writ_Bus(u8 dat) { LCD_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); // 返回數據 LCD_CS_Set();
在zk.c中將函數 void ZK_command(u8 dat) 和 u8 get_data_from_ROM(void) 修改如下。
/****************************************************************************** 函數說明:向字庫寫入命令 入口數據:dat 要寫入的命令 返回值: 無 ******************************************************************************/ void ZK_command(u8 dat) { 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); // 返回數據 } /****************************************************************************** 函數說明:從字庫讀取數據 入口數據:無 返回值: ret_data 讀取的數據 ******************************************************************************/ u8 get_data_from_ROM(void) { while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_TXE) == RESET); SPI_SendData(BSP_SPI1, 0xff); // 發送數據 while (SPI_GetFlagStatus(BSP_SPI1, SPI_FLAG_RXNE) == RESET); uint16_t Re_Value = SPI_ReceiveData(BSP_SPI1); // 返回數據 return Re_Value; //返回讀出的一個字節 }
到這里就移植完成了,請移步到4節進行移植驗證。
四、移植驗證
在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 "lcd_init.h" #include "lcd.h" #include "pic.h" int32_t main(void) { board_init(); // 開發板初始化 uart1_init(115200); // 串口1波特率115200 u8 i,j; float t=0; LCD_Init();//LCD初始化 LCD_Fill(0,0,LCD_W,LCD_H,WHITE); while(1) { LCD_ShowString(0,40,(uint8_t *)"LCD_W:",RED,WHITE,16,0); LCD_ShowIntNum(48,40,LCD_W,3,RED,WHITE,16); LCD_ShowString(80,40,(uint8_t *)"LCD_H:",RED,WHITE,16,0); LCD_ShowIntNum(128,40,LCD_H,3,RED,WHITE,16); LCD_ShowString(80,40,(uint8_t *)"LCD_H:",RED,WHITE,16,0); LCD_ShowString(0,70,(uint8_t *)"Increaseing Nun:",RED,WHITE,16,0); LCD_ShowFloatNum1(128,70,t,4,RED,WHITE,16); for(j=0;j3;j++) { for(i=0;i6;i++) { LCD_ShowPicture(40*i,120+j*40,40,40,gImage_1); } } delay_ms(1000); LCD_Fill(0,0,LCD_W,LCD_H,WHITE); Display_Asc_String(0,15,7, (uint8_t *)"ASCII_5x7",RED,WHITE); //ASC 5X7點陣 Display_Asc_String(0,25,8, (uint8_t *)"ASCII_7x8",RED,WHITE); //ASC 7X8點陣 Display_Asc_String(0,35,12, (uint8_t *)"ASCII_6x12",RED,WHITE); //ASC 6X12點陣 Display_Asc_String(0,50,16, (uint8_t *)"ASCII_8x16",RED,WHITE); //ASC 8X16點陣 Display_Asc_String(0,70,24, (uint8_t *)"ASCII_12x24",RED,WHITE); //ASC 12X24點陣 Display_Asc_String(0,100,32, (uint8_t *)"ASCII_16x32",RED,WHITE); //ASC 16X32點陣 Display_GB2312_String(0,145,12, (uint8_t *)"屏幕12x12",RED,WHITE); //12x12漢字 Display_GB2312_String(0,160,16, (uint8_t *)"屏幕16x16",RED,WHITE); //15x16漢字 Display_GB2312_String(0,179,24, (uint8_t *)"屏幕24x24",RED,WHITE); //24x24漢字 Display_GB2312_String(0,204,32, (uint8_t *)"屏幕32x3",RED,WHITE); //32x32漢字 delay_ms(1000); LCD_Fill(0,0,LCD_W,LCD_H,WHITE); Display_TimesNewRoman_String(0,15,12, (uint8_t *)"ASCII_8x12",RED,WHITE); //ASC 8x12點陣(TimesNewRoman類型) Display_TimesNewRoman_String(0,30,16, (uint8_t *)"ASCII_12x16",RED,WHITE); //ASC 12x16點陣(TimesNewRoman類型) Display_TimesNewRoman_String(0,50,24, (uint8_t *)"ASCII_16x24",RED,WHITE); //ASC 16x24點陣(TimesNewRoman類型) Display_TimesNewRoman_String(0,80,32, (uint8_t *)"ASCII_24x",RED,WHITE); //ASC 24x32點陣(TimesNewRoman類型) Display_Arial_String(0,120,12, (uint8_t *)"ASCII_8x12",RED,WHITE); //ASC 8x12點陣(Arial類型) Display_Arial_String(0,140,16, (uint8_t *)"ASCII_12x16",RED,WHITE); //ASC 12x16點陣(Arial類型) Display_Arial_String(0,160,24, (uint8_t *)"ASCII_16x24",RED,WHITE); //ASC 16x24點陣(Arial類型) Display_Arial_String(0,190,32, (uint8_t *)"ASCII_24x",RED,WHITE); //ASC 24x32點陣(Arial類型) delay_ms(1000); LCD_Fill(0,0,LCD_W,LCD_H,WHITE); } }
上電效果:
移植成功案例代碼:
鏈接:https://pan.baidu.com/s/1XyIhOFchDI-3DeNle1xT0Q?pwd=LCKF
提取碼:LCKF
?審核編輯 黃宇
-
lcd
+關注
關注
34文章
4513瀏覽量
171201 -
CW32
+關注
關注
1文章
252瀏覽量
1185
發布評論請先 登錄

評論