一、模塊來(lái)源
模塊實(shí)物展示:

資料下載鏈接:https://pan.baidu.com/s/1Q4s3fk0uy8AP5aqNZ3fBmg
資料提取碼:8888
二、規(guī)格參數(shù)
工作電壓:3.3V
工作電流:90MA
模塊尺寸:31(H) x 48(V) MM
像素大小:240(H) x 280(V)RGB
驅(qū)動(dòng)芯片:ST7789V2
通信協(xié)議:SPI
以上信息見(jiàn)廠家資料文件

文件路徑

尺寸參數(shù)
三、移植過(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移植至工程
將廠家資料路徑下的【LCD】文件夾,復(fù)制到自己的工程中。(工程可以參考入門(mén)手冊(cè)工程模板)

復(fù)制示意圖
我們打開(kāi)工程文件,將我們剛剛復(fù)制到文件夾中的文件,導(dǎo)入C文件和路徑。

將lcd_init.h文件下的 sys.h 改為 board.h。還要將lcd.h文件下的 sys.h 改為 board.h
TIP
(在左邊將lcd.c和lcd_init.c的工程目錄展開(kāi),就發(fā)現(xiàn)有l(wèi)cd_init.h和lcd.h)

修改lcd_init.h內(nèi)容

修改lcd.h內(nèi)容
將 lcd_init.c 和 lcd.c 中的 delay.h 注釋掉


分別在lcd_init.h與lcd.h文件中定義三個(gè)宏,u32、u16與u8。
#ifndef u8 #define u8 uint8_t #endif #ifndef u16 #define u16 uint16_t #endif #ifndef u32 #define u32 uint32_t #endif
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ù)位;
可以將BLK接入3.3V或懸空,代價(jià)是無(wú)法控制背光亮度。
下面分為軟件SPI移植與硬件SPI移植進(jìn)行講解。
3.4軟件SPI移植

軟件SPI接線圖
選擇好引腳后,進(jìn)入工程開(kāi)始編寫(xiě)屏幕引腳初始化代碼。 將lcd_init.c源代碼中的void LCD_GPIO_Init(void)修改為如下代碼。
void LCD_GPIO_Init(void)
{
GPIO_InitTypeDef GPIO_InitStruct; // GPIO初始化結(jié)構(gòu)體
__RCC_GPIOA_CLK_ENABLE(); // 使能GPIOA時(shí)鐘
GPIO_InitStruct.Pins = LCD_SCL_PIN| // GPIO引腳
LCD_SDA_PIN|
LCD_RES_PIN|
LCD_DC_PIN|
LCD_CS_PIN|
LCD_BLK_PIN;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽輸出
GPIO_InitStruct.Speed = GPIO_SPEED_HIGH; // 輸出速度高
GPIO_Init(CW_GPIOA, &GPIO_InitStruct); // 初始化
LCD_SCLK_Set();
LCD_MOSI_Set();
LCD_RES_Set();
LCD_DC_Set();
LCD_CS_Set();
LCD_BLK_Set();
}
將lcd_init.h中的 LCD端口定義 宏,修改為下方兩圖中的右圖樣式。
//-----------------LCD端口定義---------------- #define LCD_GPIO_PORT CW_GPIOA #define LCD_SCL_PIN GPIO_PIN_5 #define LCD_SDA_PIN GPIO_PIN_7 #define LCD_RES_PIN GPIO_PIN_3 #define LCD_DC_PIN GPIO_PIN_2 #define LCD_CS_PIN GPIO_PIN_4 #define LCD_BLK_PIN GPIO_PIN_1 #define LCD_SCLK_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_SCL_PIN, GPIO_Pin_RESET)//SCL=SCLK #define LCD_SCLK_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_SCL_PIN, GPIO_Pin_SET) #define LCD_MOSI_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_SDA_PIN, GPIO_Pin_RESET)//SDA=MOSI #define LCD_MOSI_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_SDA_PIN, GPIO_Pin_SET) #define LCD_RES_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_RESET)//RES #define LCD_RES_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_SET) #define LCD_DC_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_RESET)//DC #define LCD_DC_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_SET) #define LCD_CS_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_RESET)//CS #define LCD_CS_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_SET) #define LCD_BLK_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_PIN, GPIO_Pin_RESET)//BLK #define LCD_BLK_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_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接線。

有SPI功能的引腳

硬件SPI接線
選擇好引腳后,進(jìn)入工程開(kāi)始編寫(xiě)屏幕引腳初始化代碼。
引腳初始化配置見(jiàn)如下代碼。
void LCD_GPIO_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 = LCD_SCL_PIN| // GPIO引腳
LCD_SDA_PIN|
LCD_RES_PIN|
LCD_DC_PIN|
LCD_CS_PIN|
LCD_BLK_PIN;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽輸出
GPIO_InitStruct.Speed = GPIO_SPEED_HIGH; // 輸出速度高
GPIO_Init(LCD_GPIO_PORT, &GPIO_InitStruct); // 初始化
// 拉高
LCD_RES_Set();
LCD_DC_Set();
LCD_CS_Set();
LCD_BLK_Set();
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
}
將lcd_init.h中的 LCD端口定義 宏,修改為下方兩個(gè)圖中右圖的樣式。
//-----------------LCD端口定義---------------- #define BSP_SPI1 CW_SPI1 //GPIO AF #define SPI1_AF_SCK() PA05_AFx_SPI1SCK() #define SPI1_AF_MOSI() PA07_AFx_SPI1MOSI() #define LCD_GPIO_PORT CW_GPIOA #define LCD_SCL_PIN GPIO_PIN_5 #define LCD_SDA_PIN GPIO_PIN_7 #define LCD_RES_PIN GPIO_PIN_3 #define LCD_DC_PIN GPIO_PIN_2 #define LCD_CS_PIN GPIO_PIN_4 #define LCD_BLK_PIN GPIO_PIN_1 #define LCD_RES_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_RESET)//RES #define LCD_RES_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_RES_PIN, GPIO_Pin_SET) #define LCD_DC_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_RESET)//DC #define LCD_DC_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_DC_PIN, GPIO_Pin_SET) #define LCD_CS_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_RESET)//CS #define LCD_CS_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_CS_PIN, GPIO_Pin_SET) #define LCD_BLK_Clr() GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_PIN, GPIO_Pin_RESET)//BLK #define LCD_BLK_Set() GPIO_WritePin(LCD_GPIO_PORT, LCD_BLK_PIN, GPIO_Pin_SET)
初始化部分完,還需要修改發(fā)送數(shù)據(jù)部分。源代碼中使用的是軟件SPI,時(shí)序是由廠家編寫(xiě)完成的。我們使用硬件SPI則需要對(duì)其進(jìn)行修改。
在lcd_init.c文件中,將源代碼的 void LCD_Writ_Bus(u8 dat) 函數(shù)修改為下圖樣式。

/******************************************************************************
函數(shù)說(shuō)明:LCD串行數(shù)據(jù)寫(xiě)入函數(shù)
入口數(shù)據(jù):dat 要寫(xiě)入的串行數(shù)據(jù)
返回值: 無(wú)
******************************************************************************/
void LCD_Writ_Bus(u8 dat)
{
LCD_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ù)
LCD_CS_Set();
}
到這里硬件SPI就移植完成了,請(qǐng)移步到第4節(jié)進(jìn)行移植驗(yàn)證。
四、移植驗(yàn)證
在main.c中輸入代碼如下
/* * Change Logs: * Date Author Notes * 2024-06-17 LCKFB-LP first version */ #include "board.h" #include "stdio.h" #include "bsp_uart.h" #include "lcd.h" #include "lcd_init.h" int32_t main(void) { board_init(); // 開(kāi)發(fā)板初始化 uart1_init(115200); // 串口1波特率115200 LCD_Init();//屏幕初始化 LCD_Fill(0,0,LCD_W,LCD_H,BLACK);//清全屏為黑色 float t = 0; while(1) { LCD_ShowString(0,16*2,(uint8_t *)"LCD_W:",WHITE,BLACK,16,0); LCD_ShowIntNum(48,16*2,LCD_W,3,WHITE,BLACK,16); LCD_ShowString(80,16*2,(uint8_t *)"LCD_H:",WHITE,BLACK,16,0); LCD_ShowIntNum(128,16*2,LCD_H,3,WHITE,BLACK,16); LCD_ShowString(0,16*3,(uint8_t *)"Nun:",WHITE,BLACK,16,0); LCD_ShowFloatNum1(8*4,16*3,t,4,WHITE,BLACK,16); t+=0.11; delay_ms(1000); } }
上電驗(yàn)證:

移植成功案例(軟件和硬件SPI):
鏈接:https://pan.baidu.com/s/1IPJdozv4yD5VwKeGvWoK8w?pwd=LCKF
提取碼:LCKF
審核編輯 黃宇
-
CW32
+關(guān)注
關(guān)注
1文章
278瀏覽量
1600
發(fā)布評(píng)論請(qǐng)先 登錄
基于單片機(jī)的彩屏模塊(1.8寸彩屏程序-1)溫度-時(shí)鐘綜合顯示
基于單片機(jī)的彩屏模塊(1.8寸彩屏程序-1)TFT-紅外遙控
cw32和stm32的區(qū)別
cw32和gd32的區(qū)別
基于CW32的遙控循跡小車(chē)
CW32模塊使用 0.91寸彩屏

CW32模塊使用 1.69寸彩屏
評(píng)論