4.0寸ILI9488彩屏
模块来源
采购链接：
https://item.taobao.com/item.htm?spm=a1z09.2.0.0.5b952e8de35PKf&id=562076871528&_u=72t4uge57303
资料下载链接：
https://pan.baidu.com/s/1DWdbVY9WcOLYKITB_zdjFg
资料提取码：8888
规格参数
工作电压：3.3V
工作电流：120MA
模块尺寸：62.0(H) x 106.57(V) MM
像素大小：320(H) x 480(V)RGB
驱动芯片：ST7789V
通信协议：16位并口
管脚数量：24 Pin（2.54mm间距排针）
移植过程
我们的目标是将例程移植至天空星HC32F4A0PITB上。按照以下步骤，即可完成移植。
- 将源码导入工程；
- 根据编译报错处进行粗改；
- 修改引脚配置；
- 修改时序配置；
- 移植验证。
查看资料
打开厂家资料例程。具体路径见例程路径
在main.c文件发现对屏幕的初始化配置函数为 LCD_Init(); ，该函数里包含了对屏幕引脚的配置、对屏幕显示方式的配置。
我们主要修改的是引脚的初始化与时序的修改。
移植至工程
将厂家资料路径下的【LCD】文件夹和User文件夹下的GUI.c、GUI.h、test.c和test.h，复制到自己的工程中。自己的工程至少需要有毫秒级延时函数。（工程可以参考空白工程下载）
文件下载
空白工程下载
打开自己的工程，将我们刚刚复制过来的文件导入.c和.h文件。
将gui.h文件下的 sys.h 改为 hc32_ll.h，还要将lcd.h文件下的 sys.h 改为 hc32_ll.h ，最后在test.h文件中添加 hc32_ll.h 。
(在左边将lcd.c、GUI.c和test.c的工程目录展开，就发现有相关的头文件)
将lcd.c、gui.c 和 test.c 文件下的 delay.h 改为 board.h。
分别在lcd.h、gui.h 和 test.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引脚初始化的内容报错，接下来我们要进行引脚选择。
引脚选择
因为使用的是软件并行口，所以除了特殊引脚外，其他引脚都可以设置。时序部分厂家已经完成，我们只需要将引脚和延时配置好即可。所以对应接入的屏幕引脚请按照你的需要。这里选择的引脚见 16位并行接线。
选择好引脚后，进入工程开始编写屏幕引脚初始化代码。
为了方便后续移植，我在lcd.h处宏定义了每一个引脚，后续根据需要进行修改即可。
c
//-----------------LCD端口移植----------------
//RD
#define PORT_LCD_RD GPIO_PORT_A
#define GPIO_LCD_RD GPIO_PIN_03
//WR
#define PORT_LCD_WR GPIO_PORT_A
#define GPIO_LCD_WR GPIO_PIN_02
//CS
#define PORT_LCD_CS GPIO_PORT_A
#define GPIO_LCD_CS GPIO_PIN_00
//DC/RS
#define PORT_LCD_DC GPIO_PORT_A
#define GPIO_LCD_DC GPIO_PIN_01
//RES
#define PORT_LCD_RES GPIO_PORT_A
#define GPIO_LCD_RES GPIO_PIN_04
//BLK/BL
#define PORT_LCD_BLK GPIO_PORT_D
#define GPIO_LCD_BLK GPIO_PIN_14
//DB0
#define PORT_LCD_DB0 GPIO_PORT_A
#define GPIO_LCD_DB0 GPIO_PIN_05
//DB1
#define PORT_LCD_DB1 GPIO_PORT_A
#define GPIO_LCD_DB1 GPIO_PIN_06
//DB2
#define PORT_LCD_DB2 GPIO_PORT_A
#define GPIO_LCD_DB2 GPIO_PIN_07
//DB3
#define PORT_LCD_DB3 GPIO_PORT_E
#define GPIO_LCD_DB3 GPIO_PIN_07
//DB4
#define PORT_LCD_DB4 GPIO_PORT_E
#define GPIO_LCD_DB4 GPIO_PIN_08
//DB5
#define PORT_LCD_DB5 GPIO_PORT_E
#define GPIO_LCD_DB5 GPIO_PIN_09
//DB6
#define PORT_LCD_DB6 GPIO_PORT_E
#define GPIO_LCD_DB6 GPIO_PIN_10
//DB7
#define PORT_LCD_DB7 GPIO_PORT_E
#define GPIO_LCD_DB7 GPIO_PIN_11
//DB8
#define PORT_LCD_DB8 GPIO_PORT_E
#define GPIO_LCD_DB8 GPIO_PIN_12
//DB9
#define PORT_LCD_DB9 GPIO_PORT_E
#define GPIO_LCD_DB9 GPIO_PIN_13
//DB10
#define PORT_LCD_DB10 GPIO_PORT_E
#define GPIO_LCD_DB10 GPIO_PIN_14
//DB11
#define PORT_LCD_DB11 GPIO_PORT_E
#define GPIO_LCD_DB11 GPIO_PIN_15
//DB12
#define PORT_LCD_DB12 GPIO_PORT_B
#define GPIO_LCD_DB12 GPIO_PIN_10
//DB13
#define PORT_LCD_DB13 GPIO_PORT_B
#define GPIO_LCD_DB13 GPIO_PIN_11
//DB14
#define PORT_LCD_DB14 GPIO_PORT_B
#define GPIO_LCD_DB14 GPIO_PIN_12
//DB15
#define PORT_LCD_DB15 GPIO_PORT_B
#define GPIO_LCD_DB15 GPIO_PIN_131
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
将lcd.c源代码中新添加一个函数 void LCD_GPIO_Init(void) 为如下代码。
c
void LCD_GPIO_Init(void)
{
stc_gpio_init_t stcGpioInit; // 定义GPIO结构体
// 关闭寄存器保护
LL_PERIPH_WE(LL_PERIPH_ALL);
(void)GPIO_StructInit(&stcGpioInit);
stcGpioInit.u16PinState = PIN_STAT_SET;
stcGpioInit.u16PinDir = PIN_DIR_OUT;
// RD
(void)GPIO_Init(PORT_LCD_RD, GPIO_LCD_RD, &stcGpioInit);
// WR
(void)GPIO_Init(PORT_LCD_WR, GPIO_LCD_WR, &stcGpioInit);
// CS
(void)GPIO_Init(PORT_LCD_CS, GPIO_LCD_CS, &stcGpioInit);
// DC
(void)GPIO_Init(PORT_LCD_DC, GPIO_LCD_DC, &stcGpioInit);
// RES
(void)GPIO_Init(PORT_LCD_RES, GPIO_LCD_RES, &stcGpioInit);
// BLK
(void)GPIO_Init(PORT_LCD_BLK, GPIO_LCD_BLK, &stcGpioInit);
// DB0
(void)GPIO_Init(PORT_LCD_DB0, GPIO_LCD_DB0, &stcGpioInit);
// DB1
(void)GPIO_Init(PORT_LCD_DB1, GPIO_LCD_DB1, &stcGpioInit);
// DB2
(void)GPIO_Init(PORT_LCD_DB2, GPIO_LCD_DB2, &stcGpioInit);
// DB3
(void)GPIO_Init(PORT_LCD_DB3, GPIO_LCD_DB3, &stcGpioInit);
// DB4
(void)GPIO_Init(PORT_LCD_DB4, GPIO_LCD_DB4, &stcGpioInit);
// DB5
(void)GPIO_Init(PORT_LCD_DB5, GPIO_LCD_DB5, &stcGpioInit);
// DB6
(void)GPIO_Init(PORT_LCD_DB6, GPIO_LCD_DB6, &stcGpioInit);
// DB7
(void)GPIO_Init(PORT_LCD_DB7, GPIO_LCD_DB7, &stcGpioInit);
// DB8
(void)GPIO_Init(PORT_LCD_DB8, GPIO_LCD_DB8, &stcGpioInit);
// DB9
(void)GPIO_Init(PORT_LCD_DB9, GPIO_LCD_DB9, &stcGpioInit);
// DB10
(void)GPIO_Init(PORT_LCD_DB10, GPIO_LCD_DB10, &stcGpioInit);
// DB11
(void)GPIO_Init(PORT_LCD_DB11, GPIO_LCD_DB11, &stcGpioInit);
// DB12
(void)GPIO_Init(PORT_LCD_DB12, GPIO_LCD_DB12, &stcGpioInit);
// DB13
(void)GPIO_Init(PORT_LCD_DB13, GPIO_LCD_DB13, &stcGpioInit);
// DB14
(void)GPIO_Init(PORT_LCD_DB14, GPIO_LCD_DB14, &stcGpioInit);
// DB15
(void)GPIO_Init(PORT_LCD_DB15, GPIO_LCD_DB15, &stcGpioInit);
}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
55
56
57
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
55
56
57
然后修改 lcd.c 文件中的 void LCD_Init(void) 函数，将其修改为下面的形式
c
//初始化lcd
void LCD_Init(void)
{
LCD_GPIO_Init();
LCD_RST_CLR;
delay_ms(200); // delay 50 ms
LCD_RST_SET;
delay_ms(50); // delay 50 ms
Set_Dir(DFT_SCAN_DIR);
LCD_WR_REG(0xE0);
LCD_WR_DATA(0x00);
LCD_WR_DATA(0x07);
LCD_WR_DATA(0x0f);
LCD_WR_DATA(0x0D);
LCD_WR_DATA(0x1B);
LCD_WR_DATA(0x0A);
LCD_WR_DATA(0x3c);
LCD_WR_DATA(0x78);
LCD_WR_DATA(0x4A);
LCD_WR_DATA(0x07);
LCD_WR_DATA(0x0E);
LCD_WR_DATA(0x09);
LCD_WR_DATA(0x1B);
LCD_WR_DATA(0x1e);
LCD_WR_DATA(0x0f);
LCD_WR_REG(0xE1);
LCD_WR_DATA(0x00);
LCD_WR_DATA(0x22);
LCD_WR_DATA(0x24);
LCD_WR_DATA(0x06);
LCD_WR_DATA(0x12);
LCD_WR_DATA(0x07);
LCD_WR_DATA(0x36);
LCD_WR_DATA(0x47);
LCD_WR_DATA(0x47);
LCD_WR_DATA(0x06);
LCD_WR_DATA(0x0a);
LCD_WR_DATA(0x07);
LCD_WR_DATA(0x30);
LCD_WR_DATA(0x37);
LCD_WR_DATA(0x0f);
LCD_WR_REG(0xC0);
LCD_WR_DATA(0x10);
LCD_WR_DATA(0x10);
LCD_WR_REG(0xC1);
LCD_WR_DATA(0x41);
LCD_WR_REG(0xC5);
LCD_WR_DATA(0x00);
LCD_WR_DATA(0x22);
LCD_WR_DATA(0x80);
LCD_WR_REG(0x36); // Memory Access Control
if(DFT_SCAN_DIR==L2R_U2D)LCD_WR_DATA(0x48);
else if(DFT_SCAN_DIR==R2L_D2U)LCD_WR_DATA(0x88);
else if(DFT_SCAN_DIR==U2D_R2L)LCD_WR_DATA(0x28);
else LCD_WR_DATA(0xE8);
LCD_WR_REG(0x3A); //Interface Mode Control，
LCD_WR_DATA(0x55);
LCD_WR_REG(0XB0); //Interface Mode Control
LCD_WR_DATA(0x00);
LCD_WR_REG(0xB1); //Frame rate 70HZ
LCD_WR_DATA(0xB0);
LCD_WR_DATA(0x11);
LCD_WR_REG(0xB4);
LCD_WR_DATA(0x02);
LCD_WR_REG(0xB6); //RGB/MCU Interface Control
LCD_WR_DATA(0x02);
LCD_WR_DATA(0x02);
LCD_WR_REG(0xB7);
LCD_WR_DATA(0xC6);
LCD_WR_REG(0xE9);
LCD_WR_DATA(0x00);
LCD_WR_REG(0XF7);
LCD_WR_DATA(0xA9);
LCD_WR_DATA(0x51);
LCD_WR_DATA(0x2C);
LCD_WR_DATA(0x82);
LCD_WR_REG(0x11);
delay_ms(120);
LCD_WR_REG(0x29);
LCD_LED(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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
将lcd.h中的 LCD端口定义 宏，修改为：
c
//////////////////////////////////////////////////////////////////////////////////
//-----------------LCD端口定义----------------
#define LCD_LED(x) ( x ? GPIO_SetPins(PORT_LCD_BLK,GPIO_LCD_BLK) : GPIO_ResetPins(PORT_LCD_BLK,GPIO_LCD_BLK) )
#define LCD_CS_SET GPIO_SetPins(PORT_LCD_CS, GPIO_LCD_CS)//CS
#define LCD_RS_SET GPIO_SetPins(PORT_LCD_DC, GPIO_LCD_DC)//DC
#define LCD_WR_SET GPIO_SetPins(PORT_LCD_WR, GPIO_LCD_WR)//WR
#define LCD_RD_SET GPIO_SetPins(PORT_LCD_RD, GPIO_LCD_RD)//RD
#define LCD_RST_SET GPIO_SetPins(PORT_LCD_RES, GPIO_LCD_RES)//RES
#define LCD_CS_CLR GPIO_ResetPins(PORT_LCD_CS, GPIO_LCD_CS)//CS
#define LCD_RS_CLR GPIO_ResetPins(PORT_LCD_DC, GPIO_LCD_DC)//DC
#define LCD_WR_CLR GPIO_ResetPins(PORT_LCD_WR, GPIO_LCD_WR)//WR
#define LCD_RD_CLR GPIO_ResetPins(PORT_LCD_RD, GPIO_LCD_RD)//RD
#define LCD_RST_CLR GPIO_ResetPins(PORT_LCD_RES, GPIO_LCD_RES)//RES1
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
因为是并口屏，传输8位的数据，是一根线一个位，8个位数据就是8根线。所以我们需要将一个8位的数据，装载到8根数据线上。在 lcd_init.h 中添加以下代码，方便后续的数据传输和端口修改。
c
// x ? 置1 : 置0
#define BIT_DB15(x) ( x ? GPIO_SetPins(PORT_LCD_DB15,GPIO_LCD_DB15) : GPIO_ResetPins(PORT_LCD_DB15,GPIO_LCD_DB15) )
#define BIT_DB14(x) ( x ? GPIO_SetPins(PORT_LCD_DB14,GPIO_LCD_DB14) : GPIO_ResetPins(PORT_LCD_DB14,GPIO_LCD_DB14) )
#define BIT_DB13(x) ( x ? GPIO_SetPins(PORT_LCD_DB13,GPIO_LCD_DB13) : GPIO_ResetPins(PORT_LCD_DB13,GPIO_LCD_DB13) )
#define BIT_DB12(x) ( x ? GPIO_SetPins(PORT_LCD_DB12,GPIO_LCD_DB12) : GPIO_ResetPins(PORT_LCD_DB12,GPIO_LCD_DB12) )
#define BIT_DB11(x) ( x ? GPIO_SetPins(PORT_LCD_DB11,GPIO_LCD_DB11) : GPIO_ResetPins(PORT_LCD_DB11,GPIO_LCD_DB11) )
#define BIT_DB10(x) ( x ? GPIO_SetPins(PORT_LCD_DB10,GPIO_LCD_DB10) : GPIO_ResetPins(PORT_LCD_DB10,GPIO_LCD_DB10) )
#define BIT_DB9(x) ( x ? GPIO_SetPins(PORT_LCD_DB9,GPIO_LCD_DB9) : GPIO_ResetPins(PORT_LCD_DB9,GPIO_LCD_DB9) )
#define BIT_DB8(x) ( x ? GPIO_SetPins(PORT_LCD_DB8,GPIO_LCD_DB8) : GPIO_ResetPins(PORT_LCD_DB8,GPIO_LCD_DB8) )
#define BIT_DB7(x) ( x ? GPIO_SetPins(PORT_LCD_DB7,GPIO_LCD_DB7) : GPIO_ResetPins(PORT_LCD_DB7,GPIO_LCD_DB7) )
#define BIT_DB6(x) ( x ? GPIO_SetPins(PORT_LCD_DB6,GPIO_LCD_DB6) : GPIO_ResetPins(PORT_LCD_DB6,GPIO_LCD_DB6) )
#define BIT_DB5(x) ( x ? GPIO_SetPins(PORT_LCD_DB5,GPIO_LCD_DB5) : GPIO_ResetPins(PORT_LCD_DB5,GPIO_LCD_DB5) )
#define BIT_DB4(x) ( x ? GPIO_SetPins(PORT_LCD_DB4,GPIO_LCD_DB4) : GPIO_ResetPins(PORT_LCD_DB4,GPIO_LCD_DB4) )
#define BIT_DB3(x) ( x ? GPIO_SetPins(PORT_LCD_DB3,GPIO_LCD_DB3) : GPIO_ResetPins(PORT_LCD_DB3,GPIO_LCD_DB3) )
#define BIT_DB2(x) ( x ? GPIO_SetPins(PORT_LCD_DB2,GPIO_LCD_DB2) : GPIO_ResetPins(PORT_LCD_DB2,GPIO_LCD_DB2) )
#define BIT_DB1(x) ( x ? GPIO_SetPins(PORT_LCD_DB1,GPIO_LCD_DB1) : GPIO_ResetPins(PORT_LCD_DB1,GPIO_LCD_DB1) )
#define BIT_DB0(x) ( x ? GPIO_SetPins(PORT_LCD_DB0,GPIO_LCD_DB0) : GPIO_ResetPins(PORT_LCD_DB0,GPIO_LCD_DB0) )
#define DATAOUT(dat){ \
BIT_DB15( (dat>>15)&0x01 ); \
BIT_DB14( (dat>>14)&0x01 ); \
BIT_DB13( (dat>>13)&0x01 ); \
BIT_DB12( (dat>>12)&0x01 ); \
BIT_DB11( (dat>>11)&0x01 ); \
BIT_DB10( (dat>>10)&0x01 ); \
BIT_DB9( (dat>>9)&0x01 ); \
BIT_DB8( (dat>>8)&0x01 ); \
BIT_DB7( (dat>>7)&0x01 ); \
BIT_DB6( (dat>>6)&0x01 ); \
BIT_DB5( (dat>>5)&0x01 ); \
BIT_DB4( (dat>>4)&0x01 ); \
BIT_DB3( (dat>>3)&0x01 ); \
BIT_DB2( (dat>>2)&0x01 ); \
BIT_DB1( (dat>>1)&0x01 ); \
BIT_DB0( (dat>>0)&0x01 ); \
}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
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
将下方的注释
将读取颜色的函数注释。
打开test.c文件将 void Touch_Test(void) 函数注释掉
将lcd.c中的 u16 LCD_RD_DATA(void) 注释掉
到这里就移植完成了，请移步到11.4节进行移植验证。
移植验证
在main.c中输入代码如下
c
/*
* 立创开发板软硬件资料与相关扩展板软硬件资料官网全部开源
* 开发板官网：www.lckfb.com
* 技术支持常驻论坛，任何技术问题欢迎随时交流学习
* 立创论坛：https://oshwhub.com/forum
* 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
* 不靠卖板赚钱，以培养中国工程师为己任
* Change Logs:
* Date Author Notes
* 2024-05-16 LCKFB-LP first version
*/
#include "board.h"
#include "bsp_uart.h"
#include "stdio.h"
#include "LCD.h"
#include "test.h"
int32_t main(void)
{
board_init();
uart1_init(115200U);
LCD_Init();
LCD_Fill(0,0,320,480,YELLOW);
while(1)
{
main_test();
Test_Color();
Test_FillRec();
Test_Circle();
English_Font_test();
Chinese_Font_test();
Pic_test();
}
}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
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
模块移植成功案例代码：