一模塊來(lái)源
模塊實(shí)物展示:
資料下載鏈接:https://pan.baidu.com/s/15OWpndYzyW8kFPqmfKNfxQ
資料提取碼:8888
二規(guī)格參數(shù)
工作電壓:3.3V
工作電流:90MA
模塊尺寸:30(H) x 37(V) MM
像素大小:172(H) x 320(V)RGB
驅(qū)動(dòng)芯片:ST7789V3
管腳數(shù)量:8 Pin(2.54mm間距排針)
以上信息見(jiàn)廠家資料文件
文件路徑
尺寸參數(shù)
03移植過(guò)程
我們的目標(biāo)是將例程移植至立創(chuàng)·CW32F030C8T6開(kāi)發(fā)板上。按照以下步驟,即可完成移植。
將源碼導(dǎo)入工程;
根據(jù)編譯報(bào)錯(cuò)處進(jìn)行粗改;
修改引腳配置;
修改時(shí)序配置;
移植驗(yàn)證。
3.1查看資料
將廠家資料路徑下的【LCD】文件夾,復(fù)制到自己的工程中。(工程可以參考入門(mén)手冊(cè)工程模板)
復(fù)制示意圖
3.2移植至工程
我們打開(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?注釋掉
再編譯發(fā)現(xiàn)還有錯(cuò)誤,錯(cuò)誤內(nèi)容分別為標(biāo)識(shí)符“u8”、“u16”、“u32”未定義和找不到delay.h這個(gè)文件。
分別在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
再編譯發(fā)現(xiàn)只剩下LCD引腳初始化的內(nèi)容報(bào)錯(cuò),接下來(lái)我們要進(jìn)行引腳選擇。
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ú)法控制背光亮度。
3.4軟件SPI移植
當(dāng)前廠家源碼使用的是軟件SPI接口,SPI時(shí)序部分廠家已經(jīng)完成,我們只需要將引腳和延時(shí)配置好即可。所以對(duì)應(yīng)接入的屏幕引腳請(qǐng)按照你的需要。這里選擇的引腳見(jiàn)下表。
軟件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就移植完成了,可移步到4節(jié)進(jìn)行移植驗(yàn)證。
源端口定義
修改后端口定義
到這里軟件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(CW_GPIOA, &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
}
初始化部分完,還需要修改發(fā)送數(shù)據(jù)部分。源代碼中使用的是軟件SPI,時(shí)序是由廠家編寫(xiě)完成的。我們使用硬件SPI則需要對(duì)其進(jìn)行修改。
在lcd_init.c文件中,將源代碼的void LCD_Writ_Bus(u8 dat) 函數(shù)修改為下圖中右圖樣式。
源代碼格式
修改后的代碼
將lcd_init.h中的LCD_Writ_Bus函數(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();
}
將lcd_init.h中的LCD端口定義改為
//-----------------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)
到這里硬件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);
? ? }
}
上電效果:
移植成功案例(軟件和硬件SPI):
鏈接:https://pan.baidu.com/s/1Gh3gjERStM73AV_MiNTV0A?pwd=LCKF
提取碼:LCKF