一、模块来源
采购链接：2.2寸/2.4/2.8/3.2/3.5/4.0寸TFT触摸彩色SPI串口液晶屏显示模块
资料下载链接：http://www.lcdwiki.com/zh/2.8inch\_SPI\_Module\_ILI9341\_SKU:MSP2807
二、规格参数
工作电压：3.3V-5V
工作电流：90mA
模块尺寸：50.0(H) x 86(V) MM
像素大小：320(H) x 240(V)RGB
驱动芯片：ILI9341
通信协议：SPI
以上信息见厂家资料文件【ZJY096S0800TG01.pdf】
三、移植过程
我们的目标是将例程移植至开发板上。按照以下步骤，即可完成移植。
- 将源码导入工程；
- 根据编译报错处进行粗改；
- 修改引脚配置；
- 修改时序配置；
- 移植验证。
1、查看资料
打开厂家资料例程（例程下载见百度网盘链接下载）。具体路径见例程路径
2、移植至工程
将厂家资料路径下的【LCD】、【SPI】、【TOUCH】文件夹和User文件夹下的GUI.c、GUI.h、test.c和test.h、pic.h，复制到自己的工程中。（工程可以参考入门手册工程模板）
我们打开工程文件，将我们刚刚复制到文件夹中的文件，导入C文件和路径。
把TOUCH文件夹的路径也添加下：
本模块需要sys.h文件，sys.h的内容主要是位带操作部分，具体内容可以查看入门手册【位带操作】章节！
分别在touch.h、spi.h、gui.h 和 test.h 文件中定义三个宏，s32、u16与u8。
c
#include "stm32f10x.h"
#ifndef u8
#define u8 uint8_t
#endif
#ifndef u16
#define u16 uint16_t
#endif
#ifndef s32
#define s32 uint32_t
#endif这里需要注意，lcd.h和GUI.h中使用到的是u32类型，因此，我们需要改为u32.
将touch.c、lcd.c、GUI.c与test.c文件中的头文件delay.h改为自己的延时函数头文件，这里我使用的是board.h；
3、引脚选择
该屏幕需要设置14个接口，具体接口说明见厂家资料屏幕规格书。 当前厂家源码使用的是软件SPI接口，SPI时序部分厂家已经完成，我们只需要将硬件SPI引脚时序和延时配置好即可。所以对应接入的屏幕引脚请按照你的需要。
移植
选择好引脚后，进入工程开始编写屏幕引脚初始化代码。
为了方便后续移植，我在lcd.h处宏定义了每一个引脚，后续根据需要进行修改即可。
c
//-----------------LCD端口移植----------------
#define RCC_LCD1 RCC_APB2Periph_GPIOA
#define RCC_LCD2 RCC_APB2Periph_GPIOB
//SCK
#define PORT_LCD_SCL GPIOA
#define GPIO_LCD_SCL GPIO_Pin_6
//MOSI
#define PORT_LCD_SDA GPIOA
#define GPIO_LCD_SDA GPIO_Pin_7
////MIS0
//#define PORT_LCD_MIS GPIOB
//#define GPIO_LCD_MIS GPIO_Pin_14
//NSS
#define PORT_LCD_CS GPIOB
#define GPIO_LCD_CS GPIO_Pin_10
//DC
#define PORT_LCD_DC GPIOB
#define GPIO_LCD_DC GPIO_Pin_0
//RES
#define PORT_LCD_RES GPIOB
#define GPIO_LCD_RES GPIO_Pin_1
//BLK/LED
#define PORT_LCD_BLK GPIOA
#define GPIO_LCD_BLK GPIO_Pin_5
//CS2/T_CS
#define PORT_LCD_CS2 GPIOA
#define GPIO_LCD_CS2 GPIO_Pin_3
//PEN/T_IRQ
#define PORT_LCD_PEN GPIOA
#define GPIO_LCD_PEN GPIO_Pin_0
//T_CLK
#define PORT_LCD_TCLK GPIOA
#define GPIO_LCD_TCLK GPIO_Pin_4
//T_DIN
#define PORT_LCD_TDIN GPIOA
#define GPIO_LCD_TDIN GPIO_Pin_2
//T_DO
#define PORT_LCD_TD0 GPIOA
#define GPIO_LCD_TD0 GPIO_Pin_1将 lcd.c 源代码中的 void LCD_GPIOInit(void) 修改为如下代码。
代码中已经做了引脚SPI的适配，如果没有修改相关引脚，则将宏定义 USE_HARDWARE_SPI 宏 为 1 即可。
c
void LCD_GPIOInit(void)
{
GPIO_InitTypeDef GPIO_InitStructure;
RCC_APB2PeriphClockCmd(RCC_LCD1|RCC_LCD2 ,ENABLE);
GPIO_InitStructure.GPIO_Pin = GPIO_LCD_SCL|GPIO_LCD_SDA|GPIO_LCD_BLK;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;//推挽输出模式
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOA, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = GPIO_LCD_DC|GPIO_LCD_RES|GPIO_LCD_CS;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;//推挽输出模式
GPIO_Init(GPIOB, &GPIO_InitStructure);
}将 lcd.h 中的 LCD端口定义 宏，修改为:
c
//液晶控制口置1操作语句宏定义
#define LCD_CS_SET GPIO_WriteBit(PORT_LCD_CS, GPIO_LCD_CS, Bit_SET)
#define LCD_RS_SET GPIO_WriteBit(PORT_LCD_DC, GPIO_LCD_DC, Bit_SET)
#define LCD_SDA_SET GPIO_WriteBit(PORT_LCD_SDA, GPIO_LCD_SDA, Bit_SET)
#define LCD_SCL_SET GPIO_WriteBit(PORT_LCD_SCL, GPIO_LCD_SCL, Bit_SET)
#define LCD_RST_SET GPIO_WriteBit(PORT_LCD_RES, GPIO_LCD_RES, Bit_SET)
#define LCD_LED_SET GPIO_WriteBit(PORT_LCD_BLK, GPIO_LCD_BLK, Bit_SET)
//液晶控制口置0操作语句宏定义
#define LCD_CS_CLR GPIO_WriteBit(PORT_LCD_CS, GPIO_LCD_CS, Bit_RESET)//CS
#define LCD_RS_CLR GPIO_WriteBit(PORT_LCD_DC, GPIO_LCD_DC, Bit_RESET)//DC
#define LCD_SDA_CLR GPIO_WriteBit(PORT_LCD_SDA, GPIO_LCD_SDA, Bit_RESET)//SDA=MOSI
#define LCD_SCL_CLR GPIO_WriteBit(PORT_LCD_SCL, GPIO_LCD_SCL, Bit_RESET)//SCL=SCLK
#define LCD_RST_CLR GPIO_WriteBit(PORT_LCD_RES, GPIO_LCD_RES, Bit_RESET)//RES
#define LCD_LED_CLR GPIO_WriteBit(PORT_LCD_BLK, GPIO_LCD_BLK, Bit_RESET)在 SPI.c 文件中，找到 void SPIv_WriteData(unsigned char Data) 函数，将其修改如下。
c
void SPIv_WriteData(u8 Data)
{
unsigned char i=0;
for(i=8;i>0;i--)
{
if(Data&0x80)
LCD_SDA_SET; //输出数据
else
LCD_SDA_CLR;
LCD_SCL_CLR;
LCD_SCL_SET;
Data<<=1;
}
}在spi.h中，厂家定义了关于SPI接口的宏，这里我们将其注释，使用我们自己的方式。
打开touch.c 文件 修改以下内容：
- 修改u8 TP_Init(void)；函数
c
u8 TP_Init(void)
{
RCC_APB2PeriphClockCmd(RCC_LCD1|RCC_LCD2 ,ENABLE);
GPIO_InitTypeDef GPIO_InitStructure;
/* PEN */
GPIO_InitStructure.GPIO_Pin = GPIO_LCD_PEN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; // 上拉输入
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(PORT_LCD_PEN, &GPIO_InitStructure);
/* DOUT*/
GPIO_InitStructure.GPIO_Pin = GPIO_LCD_TD0;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; // 上拉输入
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(PORT_LCD_TD0, &GPIO_InitStructure);
/* TDIN*/
GPIO_InitStructure.GPIO_Pin = GPIO_LCD_TDIN;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;//推挽输出模式
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(PORT_LCD_TDIN, &GPIO_InitStructure);
/* TCLK*/
GPIO_InitStructure.GPIO_Pin = GPIO_LCD_TCLK;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;//推挽输出模式
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(PORT_LCD_TCLK, &GPIO_InitStructure);
/* TCS*/
GPIO_InitStructure.GPIO_Pin = GPIO_LCD_CS2;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;//推挽输出模式
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(PORT_LCD_CS2, &GPIO_InitStructure);
TP_Read_XY(&tp_dev.x,&tp_dev.y);//第一次读取初始化
return 1;
}- 注释掉 **void TP_Save_Adjdata(void)；**和 **u8 TP_Get_Adjdata(void)；**函数。
- 找到 void TP_Adjust(void) ;函数将函数里面的 TP_Save_Adjdata();和TP_Get_Adjdata();注释掉。
将test.c中的 void Touch_Test(void) 修改如下：
c
void Touch_Test(void)
{
u8 key;
u16 i=0;
u16 j=0;
u16 colorTemp=0;
TP_Init();
LCD_Clear(WHITE);//清屏
TP_Adjust(); //屏幕校准
DrawTestPage("测试9:Touch(按KEY0校准) ");
LCD_ShowString(lcddev.width-24,0,16,"RST",1);//显示清屏区域
POINT_COLOR=RED;
LCD_Fill(lcddev.width-52,2,lcddev.width-50+20,18,RED);
while(1)
{
tp_dev.scan(0);
if(tp_dev.sta&TP_PRES_DOWN) //触摸屏被按下
{
if(tp_dev.x<lcddev.width&&tp_dev.y<lcddev.height)
{
if(tp_dev.x>(lcddev.width-24)&&tp_dev.y<16)
{
DrawTestPage("测试9:Touch(按KEY0校准) ");//清除
LCD_ShowString(lcddev.width-24,0,16,"RST",1);//显示清屏区域
POINT_COLOR=colorTemp;
LCD_Fill(lcddev.width-52,2,lcddev.width-50+20,18,POINT_COLOR);
}
else if((tp_dev.x>(lcddev.width-60)&&tp_dev.x<(lcddev.width-50+20))&&tp_dev.y<20)
{
LCD_Fill(lcddev.width-52,2,lcddev.width-50+20,18,ColorTab[j%5]);
POINT_COLOR=ColorTab[(j++)%5];
colorTemp=POINT_COLOR;
delay_ms(10);
}
else TP_Draw_Big_Point(tp_dev.x,tp_dev.y,POINT_COLOR); //画图
}
}
else
{
delay_ms(10); //没有按键按下的时候
}
}
}打开 lcd.c 文件 找到 void LCD_Init(void); 函数将里面的LCD_LED=1;替换成LCD_LED_SET;
打开 touch.h 文件 将里面一部分代码改为下面的部分：
c
//与触摸屏芯片连接引脚
//与触摸屏芯片连接引脚
#define PEN PAin(0) //T_PEN
#define DOUT PAin(1) //T_MISO
#define TDIN PAout(2) //T_MOSI
#define TCLK PAout(4) //T_SCK
#define TCS PAout(3) //T_CS到这里就移植完成了，可移步到第四节进行移植验证。
四、移植验证
在main.c中输入代码如下:
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-03-28 LCKFB-LP first version
*/
#include "stm32f10x.h"
#include "board.h"
#include "bsp_uart.h"
#include "stdio.h"
#include "lcd.h"
#include "gui.h"
#include "test.h"
int main(void)
{
board_init();
uart1_init(115200);
LCD_Init(); //液晶屏初始化
while(1)
{
main_test(); //测试主界面
Test_Color(); //简单刷屏填充测试
Test_FillRec(); //GUI矩形绘图测试
Test_Circle(); //GUI画圆测试
Test_Triangle(); //GUI三角形绘图测试
English_Font_test(); //英文字体示例测试
Chinese_Font_test(); //中文字体示例测试
Pic_test(); //图片显示示例测试
Rotate_Test(); //旋转显示测试
/* 如果不带触摸，或者不需要触摸功能，请注释掉下面触摸屏测试项 */
Touch_Test(); //触摸屏手写测试
}
}上电效果：