1. 简介
最近搞了一块STM32H743的开发板，自带TFT-1.8寸的液晶屏，一直听说STemWin功能强大，想要体验一把。奈何从未移植过STemWin，下意识的感觉还是有点困难，尤其是在网上找了一番关于STemWin的移植教程之后，发现给小白看的教程实在太少，SPI接口的教程更少。因此将自己移植STemWin的过程分享出来，供大伙参考一下。

2.环境
7 w: N( G/ _' H' _$ J硬件
6 K0 E. O+ _7 h  t+ bMCU信息：STM32H743
9 a: h7 ?5 M/ `6 F3 A; GTFT屏幕信息：TFT-1.8寸液晶屏(分辨率：160xRGBx128；驱动IC：ST7735S；通讯接口：SPI)
* l6 T/ Y4 Q: X% \( N, ~
软件
4 j% ~' G6 z9 f2 {; uHAL库信息：STM32Cube_FW_H7_V1.6.0（在使用STM32CubeMX生成STM32H7工程时会提示下载，目录在：C:\Users$username$\STM32Cube\Repository\STM32Cube_FW_H7_V1.6.0）
2 b# O  L$ A) W  _8 b  q; CSTemWin信息：下载完上述的HAL库之后，STemWin也已经下载OK，具体位置如下：C:\Users$username$\STM32Cube\Repository\STM32Cube_FW_H7_V1.6.0\Middlewares\ST

+ V3 `7 \5 _9 t2 P3.移植
3 }1 `( h2 v9 g( `, \0 F3.1 移植前准备
开发板提供了TFT-1.8寸LCD的SPI驱动Demo，屏幕可以正常使用，我是基于该工程进行的移植。重点关注Demo中的以下几个函数，函数名可能跟我提供的有所出入，具体视自己的LCD驱动代码而定。
2 [3 E7 d% F! ~
+ o- L* m- \: x; U8 fLCD_Init(void) --------------------------- SPI驱动代码，以及LCD的初始化
3 T$ [4 p/ J( H3 i5 ZLCD_WriteCmd(uint8_t cmd)---------LCD写命令
* O. Z5 B4 b; h3 o. e/ GLCD_WriteData(uint8_t data)---------LCD写数据
* S- y. D% c$ ]5 r; d工程目录中，如果有lcd.c，lcd.h，gui.c，gui.h，请先将文件重命名，并更改工程文件，并保证编译之后运行依然OK。
+ s& p- X6 N$ G" \/ x& @  h3.2 开始移植
. i, r3 o( G9 p( H; u  F将整个STemWin目录拷贝到工程目录下:

: U3 y$ D, \& h7 x

! O$ z" t* ~/ q6 f  r9 q: c5 v6 J7 i7 _打开LCD Demo的工程文件，将STemWin下必要的文件添加进工程，具体文件以及路径如下：

% L8 e2 w- P. M1 mSTemWin/Config/GUIConf.c
STemWin/Config/GUIConf.h
STemWin/Config/GUIDRV_Template.c
STemWin/Config/LCDConf_FlexColor_Template.c
STemWin/Lib/STemWin_CM7_wc16_ARGB.a
STemWin/OS/GUI_X.c
& }7 u! j: W6 o8 n  O. `- R6 r添加完成之后，工程目录结构中如下：
/ s8 o. E( A9 c  V: x+ O! B. S* z; c

" }/ f& \2 H7 w# E7 p1 |* y
将STemWin_CM7_wc16_ARGB.a设置为库文件，具体配置方法如下:
3 m) f. e% ~$ o! E

修改工程的头文件包含路径，增加以下几个路径：

3.3 修改代码
3.3.1 修改LCDConf_FlexColor_Template.c
; @; R) z  l" t& K找到XSIZE_PHYS和YSIZE_PHYS，并修改为实际LCD的分辨率
' V. n: ?' X( ^9 j

) x! ]0 ~' c) t1 f2 O3 W修改LCD_X_Config(void)，具体修改为
6 _- @5 R. o; U2 g5 N0 v
" W/ C: l, u0 o. s8 e# y, y5 P" q4 d

修改LCD_X_DisplayDriver(void)，加入我们自己的LCD屏的初始化函数。

3 ?4 F4 N( B9 ?  ~- }2 Y' ?9 R

6 B7 F) E/ I. T1 j/ y: y
* w# |5 M: ~. U; b' z9 n修改一下几个函数，该方法根据具体使用的LCD确定，本例程使用的是SPI通讯的LCD屏幕，指令和数据均为 8 bit
, s! d9 K- |2 H7 M- Z
. c2 m, r2 F) f8 F3 e- CLcdWriteReg(U16 Data) —> LcdWriteReg(U8 Data)
LcdWriteData(U16 Data) —> LcdWriteData(U8 Data)
% X, R# T* D! v5 a+ L5 jLcdWriteDataMultiple(U16 * pData, int NumItems) —> LcdWriteDataMultiple(U8 * pData, int NumItems)
6 Q# z  d! O' y% }
9 {2 g, j/ v" S5 m

  m( K# h5 \. t/ ~/ H
3.3.2 修改GUIDRV_Template.c
) C: B: `( J) Y  B% k找到 ，加入LCD的画点函数，该函数由LCD驱动 Demo提供，需要根据自己的LCD驱动代码来进行添加。
# A- d% \; P! Q0 _7 ~( n8 \6 W3 s
7 p1 G& a6 R. F0 x# ]

3 |' p" b- O, N3.3.3 修改GUConf.c
修改GUI使用的SDRam大小
6 Y- i7 A- d2 E1 I8 V7 e. Z+ P

' P, h1 f& Q0 b, K
6 R1 `- w% }! S5 O7 M3.3.4 新建一个空文件 LCDConf.h
$ \5 u, i: @. `' a6 \3 }: U7 }4 n

3 m+ G. e& E* @1 N3.3.5 由于采用的是RGB格式的LCD屏，因此需要修改GUI_ConfDefaults.h，否则可能会以BGR的方式显示。

8 V9 a% E4 X2 E% U6 n) Z1 j

/ h  j' A. m* s0 [4 m5 G
3.3.6 修改stm32h7xx_it.c中的SysTick_Handler函数，加入一下代码，由于GUI_Delay会使用到OS_TimeMS，因此如果不加该段代码，GUI_Delay将无限延时
' B! l- v# A. U' y
: I; P' u* q- H: v

5 v/ m; O' h+ q$ }# C1 ~  ~
4 验证
在main方法中，包含头文件GUI.h，并加入测试代码

8 C& Q# T4 i6 g8 a
6 U' ^. ?! ?1 r7 ^5 @实际显示效果：

' ?: s# ?5 ^/ R

7 X+ K0 Z' P$ E3 l" V- u4 t5 总结
: ?5 u3 E9 h; _6 D& K对于一名没有用过STemWin的小白来说，移植还算顺利，比想象中的要Easy一些，中途参考了各方教程，并结合自己的理解，完成了这一次移植。本次移植采用的是GUIDRV_Template_API的方式，后来也有使用GUIDRV_FLEXCOLOR的方式移植了一下，这个后续有空再补。

5 K. i2 s( @* f* R5 e7 P
1 G# W9 D; a: \2 W; x8 h# W
0 o5 D# F  M% U' ^7 _- i$ z  S