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

2.环境
, q* v- J% E, e1 u6 q硬件
MCU信息：STM32H743
1 p2 X) W: d2 a! r2 L1 ZTFT屏幕信息：TFT-1.8寸液晶屏(分辨率：160xRGBx128；驱动IC：ST7735S；通讯接口：SPI)
% s/ ]  I- c# ]4 n; J8 c
软件
HAL库信息：STM32Cube_FW_H7_V1.6.0（在使用STM32CubeMX生成STM32H7工程时会提示下载，目录在：C:\Users$username$\STM32Cube\Repository\STM32Cube_FW_H7_V1.6.0）
5 V. `' F, Y6 X2 i' B2 w! ^STemWin信息：下载完上述的HAL库之后，STemWin也已经下载OK，具体位置如下：C:\Users$username$\STM32Cube\Repository\STM32Cube_FW_H7_V1.6.0\Middlewares\ST
& f% O$ n8 C1 j+ I/ x
3 c! ~2 f9 ^$ A

9 X8 U' ]5 L2 ^+ B0 r* j* ]/ w
" e. w% ~' |6 @# a3.移植
3.1 移植前准备
' D9 f0 E* m5 ~: |+ k! |% g开发板提供了TFT-1.8寸LCD的SPI驱动Demo，屏幕可以正常使用，我是基于该工程进行的移植。重点关注Demo中的以下几个函数，函数名可能跟我提供的有所出入，具体视自己的LCD驱动代码而定。

% L: k% e/ S' h1 GLCD_Init(void) --------------------------- SPI驱动代码，以及LCD的初始化
LCD_WriteCmd(uint8_t cmd)---------LCD写命令
# k! N. z- `  [2 yLCD_WriteData(uint8_t data)---------LCD写数据
工程目录中，如果有lcd.c，lcd.h，gui.c，gui.h，请先将文件重命名，并更改工程文件，并保证编译之后运行依然OK。
- W# @1 |  T$ b( g3.2 开始移植
将整个STemWin目录拷贝到工程目录下:

" J# _# S! y0 O* u& B4 ^

. t$ Z( J+ {, o1 D2 }
8 J- J" y3 S) H0 I打开LCD Demo的工程文件，将STemWin下必要的文件添加进工程，具体文件以及路径如下：

STemWin/Config/GUIConf.c
STemWin/Config/GUIConf.h
STemWin/Config/GUIDRV_Template.c
) N; c$ Q0 U3 E% Y; G9 J. vSTemWin/Config/LCDConf_FlexColor_Template.c
, l1 V6 V" \) XSTemWin/Lib/STemWin_CM7_wc16_ARGB.a
: V/ C7 @: f0 x; X. V" VSTemWin/OS/GUI_X.c
  e: T% Y$ N' ?! s, a. f添加完成之后，工程目录结构中如下：

5 I1 W# ~7 u+ _3 \: p4 O6 p
将STemWin_CM7_wc16_ARGB.a设置为库文件，具体配置方法如下:

6 F2 p# w6 p9 Q3 ^5 g8 s

7 Q- d: |  {# T# Q
- d8 T% C& o. N; i3 ]4 Y修改工程的头文件包含路径，增加以下几个路径：

8 h# W: B5 i) ]# T9 N  @9 A3.3 修改代码
3.3.1 修改LCDConf_FlexColor_Template.c
; Q7 e, N% P* P# n: k0 _  W. M找到XSIZE_PHYS和YSIZE_PHYS，并修改为实际LCD的分辨率

3 {" `* ?% ?) ]( K. X# W
修改LCD_X_Config(void)，具体修改为
! ?( F9 L% \( f+ `  Z! i! t
# d& L; D0 U0 T6 _( I

3 M! i( R$ Q- ]1 u& h
修改LCD_X_DisplayDriver(void)，加入我们自己的LCD屏的初始化函数。
( a9 T: s. ]% g" q; u- O
  y! `" h( q) k+ w6 B

5 E! T% [$ e3 N! w% a" q! ?4 z修改一下几个函数，该方法根据具体使用的LCD确定，本例程使用的是SPI通讯的LCD屏幕，指令和数据均为 8 bit
" Y5 T1 [6 l* X
1 s" O6 L' i0 ^; tLcdWriteReg(U16 Data) —> LcdWriteReg(U8 Data)
LcdWriteData(U16 Data) —> LcdWriteData(U8 Data)
! i. w" @% F/ k9 i1 B) P, @LcdWriteDataMultiple(U16 * pData, int NumItems) —> LcdWriteDataMultiple(U8 * pData, int NumItems)

4 }2 T, t; @( }' e& l
3.3.2 修改GUIDRV_Template.c
找到 ，加入LCD的画点函数，该函数由LCD驱动 Demo提供，需要根据自己的LCD驱动代码来进行添加。

5 p6 ]9 s: u, T* l) o% x

6 I5 d7 z! t! \3 B6 t3.3.3 修改GUConf.c
7 g. O! {6 w9 k% Q修改GUI使用的SDRam大小
, D! U4 i: \" o

3.3.4 新建一个空文件 LCDConf.h
5 |! S1 w/ B5 e, {+ y" \
6 e6 Z4 V  I' B6 k7 v/ b

3.3.5 由于采用的是RGB格式的LCD屏，因此需要修改GUI_ConfDefaults.h，否则可能会以BGR的方式显示。
0 Q& }1 R& [& o3 B$ w6 g0 M4 U

; P5 L  H8 Y8 v! N  B! e
3.3.6 修改stm32h7xx_it.c中的SysTick_Handler函数，加入一下代码，由于GUI_Delay会使用到OS_TimeMS，因此如果不加该段代码，GUI_Delay将无限延时

4 验证
在main方法中，包含头文件GUI.h，并加入测试代码

* i4 p% n* Y* A5 Q

* p7 ~+ z( E1 `0 u  ~" X
实际显示效果：
6 o  w1 [7 n0 x+ m' {

0 W" w5 E. W* _2 a* e& a
" t" B0 H" J% e$ o- y5 Q' \9 D6 z4 i5 总结
对于一名没有用过STemWin的小白来说，移植还算顺利，比想象中的要Easy一些，中途参考了各方教程，并结合自己的理解，完成了这一次移植。本次移植采用的是GUIDRV_Template_API的方式，后来也有使用GUIDRV_FLEXCOLOR的方式移植了一下，这个后续有空再补。



: Y  a# t& I: A