2.2寸ILI9225彩屏
模块来源
采购链接：
https://item.taobao.com/item.htm?spm=a21n57.1.0.0.5cb3523chlpcq5&id=38360709299&ns=1&abbucket=0
资料下载链接：
http://pan.baidu.com/s/1ntDixJz
规格参数
工作电压：3.3V
工作电流：20MA
模块尺寸：67.20(H) x 42.46(W)
像素大小：176(H) x 220(V)RGB
驱动芯片：ILI9225
通信协议：SPI
使用管脚数量：8 Pin（2.54mm间距排针）
移植过程
我们的目标是将例程移植至立创开发板GD32E230C8T6上。按照以下步骤，即可完成移植。
- 将源码导入工程；
- 根据编译报错处进行粗改；
- 修改引脚配置；
- 修改时序配置；
- 移植验证。
查看资料
打开厂家资料例程。具体路径见例程路径
我们主要修改的是引脚的初始化与时序的修改。
移植至工程
将厂家资料路径下的关于LCD底层的代码，复制到自己的工程中。自己的工程至少需要有毫秒级延时函数。（工程可以参考入门手册空白工程（工程模板）下载）
打开我们的工程，将C文件导入到工程目录中。
WARNING
📌 注意：我们无需再去添加头文件路径了，因为空白工程中为大家已经添加了Hardware文件夹的路径，所以不需要再次添加！
我们将每个文件的头文件导入语句改为：
c
// main.c
#include "gd32e23x.h"
#include "systick.h"
#include <stdio.h>
#include "GUI.h"
#include "Lcd_Driver.h"1
2
3
4
5
6
2
3
4
5
6
c
// GUI.c
#include "gd32e23x.h"
#include "Lcd_Driver.h"
#include "GUI.h"
#include "font.h"1
2
3
4
5
2
3
4
5
c
// Lcd_Driver.c
#include "gd32e23x.h"
#include "Lcd_Driver.h"1
2
3
2
3
c
// Lcd_Driver.h
#include "gd32e23x.h"1
2
2
c
// GUI.h
#include "gd32e23x.h"1
2
2
分别在 Lcd_Driver.h与GUI.h 文件中定义三个宏，u32、u16与u8。
c
#ifndef u8
#define u8 uint8_t
#endif
#ifndef u16
#define u16 uint16_t
#endif
#ifndef u32
#define u32 uint32_t
#endif1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
再编译发现只剩下LCD引脚初始化的内容报错，接下来我们要进行引脚选择。
引脚选择
该屏幕需要设置8个接口，具体接口说明见 表1.12.3.1 各引脚说明。
当前厂家源码使用的是软硬件SPI接口，SPI时序部分厂家已经完成，我们只需要将硬件SPI引脚时序和延时配置好即可。所以对应接入的屏幕引脚请按照你的需要。这里选择的引脚见表1.12.3.2 屏幕接线。
选择好引脚后，进入工程开始编写屏幕引脚初始化代码。
为了方便后续移植，我在Lcd_Driver.h处宏定义了每一个引脚，后续根据需要进行修改即可。
c
//-----------------LCD端口移植----------------
//VCC - 3.3V
//SCL - PA5
//SDA - PA7
//RES - PA1(可以接入复位)
//DC - PA2
//CS - PA4
//BLK - PA3
#define RCU_LCD_SCL RCU_GPIOA//SCK
#define PORT_LCD_SCL GPIOA
#define GPIO_LCD_SCL GPIO_PIN_5
#define RCU_LCD_SDA RCU_GPIOA//MOSI
#define PORT_LCD_SDA GPIOA
#define GPIO_LCD_SDA GPIO_PIN_7
#define RCU_LCD_CS RCU_GPIOA//NSS
#define PORT_LCD_CS GPIOA
#define GPIO_LCD_CS GPIO_PIN_4
#define RCU_LCD_DC RCU_GPIOA //DC
#define PORT_LCD_DC GPIOA
#define GPIO_LCD_DC GPIO_PIN_2
#define RCU_LCD_RES RCU_GPIOA//RES
#define PORT_LCD_RES GPIOA
#define GPIO_LCD_RES GPIO_PIN_1
#define RCU_LCD_BLK RCU_GPIOA//BLK
#define PORT_LCD_BLK GPIOA
#define GPIO_LCD_BLK GPIO_PIN_3
#define RCU_SPI_HARDWARE RCU_SPI0
#define PORT_SPI SPI0
#define LINE_AF_SPI GPIO_AF_01
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
将 Lcd_Driver.c 源代码中的 void LCD_GPIO_Init(void) 修改为如下代码。
c
void LCD_GPIO_Init(void)
{
/* 使能时钟 */
rcu_periph_clock_enable(RCU_LCD_SCL);
rcu_periph_clock_enable(RCU_LCD_SDA);
rcu_periph_clock_enable(RCU_LCD_CS);
rcu_periph_clock_enable(RCU_LCD_DC);
rcu_periph_clock_enable(RCU_LCD_RES);
rcu_periph_clock_enable(RCU_LCD_BLK);
/* 配置SCL */
gpio_mode_set(PORT_LCD_SCL,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_SCL);
gpio_output_options_set(PORT_LCD_SCL,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_SCL);
gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, SET);
/* 配置SDA */
gpio_mode_set(PORT_LCD_SDA,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_SDA);
gpio_output_options_set(PORT_LCD_SDA,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_SDA);
gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, SET);
/* 配置DC */
gpio_mode_set(PORT_LCD_DC,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_DC);
gpio_output_options_set(PORT_LCD_DC,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_DC);
gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET);
/* 配置CS */
gpio_mode_set(PORT_LCD_CS,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_CS);
gpio_output_options_set(PORT_LCD_CS,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_CS);
gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET);
/* 配置RES */
gpio_mode_set(PORT_LCD_RES,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_RES);
gpio_output_options_set(PORT_LCD_RES,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_RES);
gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET);
/* 配置BLK */
gpio_mode_set(PORT_LCD_BLK, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_BLK);
gpio_output_options_set(PORT_LCD_BLK, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_BLK);
gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET);
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
将Lcd_Driver.h中的 LCD端口定义 宏，修改为图1.12.3.22样式。
c
//液晶控制口置1操作语句宏定义
#define LCD_CS_SET gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET)
#define LCD_RS_SET gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET)
#define LCD_SDA_SET gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, SET)
#define LCD_SCL_SET gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, SET)
#define LCD_RST_SET gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET)
#define LCD_LED_SET gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET)
//液晶控制口置0操作语句宏定义
#define LCD_CS_CLR gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, RESET)//CS
#define LCD_RS_CLR gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, RESET)//DC
#define LCD_SDA_CLR gpio_bit_write(PORT_LCD_SDA, GPIO_LCD_SDA, RESET)//SDA=MOSI
#define LCD_SCL_CLR gpio_bit_write(PORT_LCD_SCL, GPIO_LCD_SCL, RESET)//SCL=SCLK
#define LCD_RST_CLR gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, RESET)//RES
#define LCD_LED_CLR gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, RESET)1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
在 Lcd_Driver.c 文件中，找到 u8 SPI_WriteByte(SPI_TypeDef* SPIx,u8 Byte) 函数，将其修改如下。
c
u8 SPI_WriteByte(u8 Byte)
{
while(RESET == spi_i2s_flag_get(PORT_SPI, SPI_FLAG_TBE));
spi_i2s_data_transmit(PORT_SPI, Byte);
while(RESET == spi_i2s_flag_get(PORT_SPI, SPI_FLAG_RBNE));
spi_i2s_data_receive(PORT_SPI);
}1
2
3
4
5
6
7
2
3
4
5
6
7
这里因为我们修改了u8 SPI_WriteByte(SPI_TypeDef* SPIx,u8 Byte)，减少传入了一个参数SPIx，所以后面使用到该函数的地方，都减少一个参数传递。
在 Lcd_Driver.c 文件中，找到 void Lcd_WriteIndex(u8 Index) 和 void Lcd_WriteData(u8 Data) 函数，将其修改如下。
在 Lcd_Driver.c 文件中，找到 void SPI2_Init(void) 函数，将其修改为GD32的SPI初始化，将其修改如下。
c
void SPI2_Init(void)
{
spi_parameter_struct spi_init_struct;
/* 开启各引脚时钟 */
rcu_periph_clock_enable(RCU_LCD_SCL);
rcu_periph_clock_enable(RCU_LCD_SDA);
rcu_periph_clock_enable(RCU_LCD_CS);
rcu_periph_clock_enable(RCU_LCD_DC);
rcu_periph_clock_enable(RCU_LCD_RES);
rcu_periph_clock_enable(RCU_LCD_BLK);
/* 使能SPI */
rcu_periph_clock_enable(RCU_SPI_HARDWARE);
/* 配置 SPI的SCK GPIO */
gpio_af_set(PORT_LCD_SCL, LINE_AF_SPI, GPIO_LCD_SCL);
gpio_mode_set(PORT_LCD_SCL, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_LCD_SCL);
gpio_output_options_set(PORT_LCD_SCL, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_SCL);
gpio_bit_set(PORT_LCD_SCL,GPIO_LCD_SCL);
/* 配置 SPI的MOSI GPIO */
gpio_af_set(PORT_LCD_SDA, LINE_AF_SPI, GPIO_LCD_SDA);
gpio_mode_set(PORT_LCD_SDA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO_LCD_SDA);
gpio_output_options_set(PORT_LCD_SDA, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_SDA);
gpio_bit_set(PORT_LCD_SDA, GPIO_LCD_SDA);
/* 配置DC */
gpio_mode_set(PORT_LCD_DC,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_DC);
gpio_output_options_set(PORT_LCD_DC,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_DC);
gpio_bit_write(PORT_LCD_DC, GPIO_LCD_DC, SET);
/* 配置RES */
gpio_mode_set(PORT_LCD_RES,GPIO_MODE_OUTPUT,GPIO_PUPD_PULLUP,GPIO_LCD_RES);
gpio_output_options_set(PORT_LCD_RES,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_RES);
gpio_bit_write(PORT_LCD_RES, GPIO_LCD_RES, SET);
/* 配置BLK */
gpio_mode_set(PORT_LCD_BLK, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_LCD_BLK);
gpio_output_options_set(PORT_LCD_BLK, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_LCD_BLK);
gpio_bit_write(PORT_LCD_BLK, GPIO_LCD_BLK, SET);
/* 配置CS */
gpio_mode_set(PORT_LCD_CS,GPIO_MODE_OUTPUT,GPIO_PUPD_NONE,GPIO_LCD_CS);
gpio_output_options_set(PORT_LCD_CS,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,GPIO_LCD_CS);
gpio_bit_write(PORT_LCD_CS, GPIO_LCD_CS, SET);
/* 配置 SPI 参数 */
spi_init_struct.trans_mode = SPI_TRANSMODE_FULLDUPLEX; // 传输模式全双工
spi_init_struct.device_mode = SPI_MASTER; // 配置为主机
spi_init_struct.frame_size = SPI_FRAMESIZE_8BIT; // 8位数据
spi_init_struct.clock_polarity_phase = SPI_CK_PL_HIGH_PH_2EDGE;
spi_init_struct.nss = SPI_NSS_SOFT; // 软件cs
spi_init_struct.prescale = SPI_PSC_2;//2分频
spi_init_struct.endian = SPI_ENDIAN_MSB;
spi_init(PORT_SPI, &spi_init_struct);
/* 使能 SPI */
spi_enable(PORT_SPI);
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
然后我们在 Lcd_Driver.c 文件中找到 void SPI_SetSpeed(SPI_TypeDef* SPIx,u8 SpeedSet) 这个函数，将这个函数删掉，也可以注释掉，我们用不到这个函数。（这里我们注释掉）
到这里就移植完成了，请移步到1.7.4节进行移植验证。
移植验证
在main.c中输入代码如下
c
/******************************************************************************
* 测试硬件：立创开发板·GD32E230C8T6 使用主频72Mhz 晶振8Mhz
* 版 本 号: V1.0
* 修改作者: www.lckfb.com
* 修改日期: 2023年11月02日
* 功能介绍:
*****************************************************************************
* 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：club.szlcsc.com
* 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include "GUI.h"
#include "Lcd_Driver.h"
int main(void)
{
systick_config();//滴答定时器初始化 1ms
Lcd_Init();
LCD_LED_SET;//通过IO控制背光亮
Lcd_Clear(GRAY0);
Gui_DrawFont_GBK16(16,20,RED,GRAY0,"液晶测试程序");
DisplayButtonUp(15,38,113,58); //x1,y1,x2,y2
Gui_DrawFont_GBK16(16,40,YELLOW,GRAY0,"颜色填充测试");
DisplayButtonUp(15,68,113,88); //x1,y1,x2,y2
Gui_DrawFont_GBK16(16,70,BLUE,GRAY0,"文字显示测试");
DisplayButtonUp(15,98,113,118); //x1,y1,x2,y2
Gui_DrawFont_GBK16(16,100,RED,GRAY0,"图片显示测试");
Gui_DrawFont_GBK16(16,140,RED,GRAY0, "Welcome");
while(1)
{
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
上电效果
成功案例：