1. 简介
, e( o9 r0 a7 c" C最近搞了一块STM32H743的开发板，自带TFT-1.8寸的液晶屏，一直听说STemWin功能强大，想要体验一把。奈何从未移植过STemWin，下意识的感觉还是有点困难，尤其是在网上找了一番关于STemWin的移植教程之后，发现给小白看的教程实在太少，SPI接口的教程更少。因此将自己移植STemWin的过程分享出来，供大伙参考一下。
  ~: h# B! ~4 [. o9 w$ f& d  W. f
7 t& W/ H8 H5 m6 R' @, T1 m1 e2.环境
硬件
MCU信息：STM32H743
" M9 C3 C: k7 O- T4 `8 STFT屏幕信息：TFT-1.8寸液晶屏(分辨率：160xRGBx128；驱动IC：ST7735S；通讯接口：SPI)

软件
HAL库信息：STM32Cube_FW_H7_V1.6.0（在使用STM32CubeMX生成STM32H7工程时会提示下载，目录在：C:\Users$username$\STM32Cube\Repository\STM32Cube_FW_H7_V1.6.0）
STemWin信息：下载完上述的HAL库之后，STemWin也已经下载OK，具体位置如下：C:\Users$username$\STM32Cube\Repository\STM32Cube_FW_H7_V1.6.0\Middlewares\ST

8 D; c" ?- w: G9 {3 S
) t) E* j$ o. J  H) g3.移植
2 a. Z: L, Z. P+ V* `# Y3.1 移植前准备
! v8 X  y  q0 U% _4 P开发板提供了TFT-1.8寸LCD的SPI驱动Demo，屏幕可以正常使用，我是基于该工程进行的移植。重点关注Demo中的以下几个函数，函数名可能跟我提供的有所出入，具体视自己的LCD驱动代码而定。
! S9 ^2 Y  p, P7 u' `
' J9 L+ a2 r0 }0 i& ILCD_Init(void) --------------------------- SPI驱动代码，以及LCD的初始化
LCD_WriteCmd(uint8_t cmd)---------LCD写命令
5 Z4 g0 `' ^" h6 K- S$ T! H5 aLCD_WriteData(uint8_t data)---------LCD写数据
) X! U7 T$ K7 B! B  A4 ]) j工程目录中，如果有lcd.c，lcd.h，gui.c，gui.h，请先将文件重命名，并更改工程文件，并保证编译之后运行依然OK。
2 X- w6 u& K! S% [3 e- d3.2 开始移植
, V  O' Z6 J- u9 K: W7 v2 M  g将整个STemWin目录拷贝到工程目录下:

/ F) M" D( Q+ _/ G7 {$ `( e; Y

; }* q7 w# ?* j! M
打开LCD Demo的工程文件，将STemWin下必要的文件添加进工程，具体文件以及路径如下：

STemWin/Config/GUIConf.c
STemWin/Config/GUIConf.h
) @8 ^  z" y* H/ r5 d2 Y8 A3 A, @' TSTemWin/Config/GUIDRV_Template.c
4 N; w, K- p( O1 b) c' t( b5 ?/ nSTemWin/Config/LCDConf_FlexColor_Template.c
STemWin/Lib/STemWin_CM7_wc16_ARGB.a
) V: V% e$ w, ~& r( ~' ESTemWin/OS/GUI_X.c
添加完成之后，工程目录结构中如下：
' D& o1 y0 k# D8 X

) c9 n0 A& z& F- E. m
将STemWin_CM7_wc16_ARGB.a设置为库文件，具体配置方法如下:
" |  o* H& [$ n7 J" N, [
# V  w" L+ X3 o5 n) Q7 Y; i

修改工程的头文件包含路径，增加以下几个路径：
& Q" l* h+ X6 y- v

! n, U- [* j- _) [8 n1 l( g3.3 修改代码
3.3.1 修改LCDConf_FlexColor_Template.c
& J" c/ C$ m  d. w/ \找到XSIZE_PHYS和YSIZE_PHYS，并修改为实际LCD的分辨率
+ k' W  A4 O/ ]6 v1 W+ |% x

修改LCD_X_Config(void)，具体修改为

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

8 W9 c9 w. L8 z% @3 L5 W& v

6 D2 G3 r; l" q
3 L& Y$ u2 F/ G) r& c5 ~修改一下几个函数，该方法根据具体使用的LCD确定，本例程使用的是SPI通讯的LCD屏幕，指令和数据均为 8 bit

" `1 X2 O0 C( u- h4 VLcdWriteReg(U16 Data) —> LcdWriteReg(U8 Data)
LcdWriteData(U16 Data) —> LcdWriteData(U8 Data)
LcdWriteDataMultiple(U16 * pData, int NumItems) —> LcdWriteDataMultiple(U8 * pData, int NumItems)

2 L4 z2 g0 U, Q" v/ D& G2 {

5 v% |7 {  G' h5 J; l/ A
3.3.2 修改GUIDRV_Template.c
找到 ，加入LCD的画点函数，该函数由LCD驱动 Demo提供，需要根据自己的LCD驱动代码来进行添加。

- p( I# o, q/ a  p- G* z  x/ C
' a+ J. ^7 `8 N* L3.3.3 修改GUConf.c
修改GUI使用的SDRam大小
4 |5 R, |1 W! M, x, U& J, h
& U7 f+ I, I3 J% K7 q: Q

3 Q  \: F- }" a5 d3.3.4 新建一个空文件 LCDConf.h

: s8 L1 I. h7 F
! p0 x% }1 ]) \# [3.3.5 由于采用的是RGB格式的LCD屏，因此需要修改GUI_ConfDefaults.h，否则可能会以BGR的方式显示。
( `# A, u6 i% w6 b5 ^

) q% G$ `3 b! l) Y
3.3.6 修改stm32h7xx_it.c中的SysTick_Handler函数，加入一下代码，由于GUI_Delay会使用到OS_TimeMS，因此如果不加该段代码，GUI_Delay将无限延时

, `! j$ m; V" ?) n( N  ~4 验证
在main方法中，包含头文件GUI.h，并加入测试代码
4 P& w0 V/ f; b8 {: [

# q( s/ ]- B$ e2 @
实际显示效果：
- [0 M: g7 a( [1 r3 R" B- ?
: l! n! _2 _5 Z  S; |

9 \3 p/ Y; H! t% b5 q% k; W/ \
5 总结
对于一名没有用过STemWin的小白来说，移植还算顺利，比想象中的要Easy一些，中途参考了各方教程，并结合自己的理解，完成了这一次移植。本次移植采用的是GUIDRV_Template_API的方式，后来也有使用GUIDRV_FLEXCOLOR的方式移植了一下，这个后续有空再补。
( k1 W- w5 q1 A6 g8 d1 o( P' ^
% l/ K1 k2 L" E2 h8 l; F