1. 简介
最近搞了一块STM32H743的开发板，自带TFT-1.8寸的液晶屏，一直听说STemWin功能强大，想要体验一把。奈何从未移植过STemWin，下意识的感觉还是有点困难，尤其是在网上找了一番关于STemWin的移植教程之后，发现给小白看的教程实在太少，SPI接口的教程更少。因此将自己移植STemWin的过程分享出来，供大伙参考一下。
0 g% a& x, l' B
  ~0 @) F  `' L( o7 z2.环境
7 p  ?3 V7 y5 ?硬件
2 O8 _( t  ~9 S/ ]! h6 KMCU信息：STM32H743
; B( P: k; T+ y8 KTFT屏幕信息：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）
0 k$ x) V- _3 o8 L: B% TSTemWin信息：下载完上述的HAL库之后，STemWin也已经下载OK，具体位置如下：C:\Users$username$\STM32Cube\Repository\STM32Cube_FW_H7_V1.6.0\Middlewares\ST

# i7 p- H4 Y) b0 i( V8 e7 Z0 L3.移植
: |8 ]( B5 h( G( j1 F! y3.1 移植前准备
! N! m2 a0 @" I5 T' S% a开发板提供了TFT-1.8寸LCD的SPI驱动Demo，屏幕可以正常使用，我是基于该工程进行的移植。重点关注Demo中的以下几个函数，函数名可能跟我提供的有所出入，具体视自己的LCD驱动代码而定。
- @: B3 j  o% k6 E7 Q
, c% ?: Q2 S& Z/ Y1 \LCD_Init(void) --------------------------- SPI驱动代码，以及LCD的初始化
LCD_WriteCmd(uint8_t cmd)---------LCD写命令
  j+ M3 p$ v, b" @/ V& E$ G9 VLCD_WriteData(uint8_t data)---------LCD写数据
工程目录中，如果有lcd.c，lcd.h，gui.c，gui.h，请先将文件重命名，并更改工程文件，并保证编译之后运行依然OK。
; e) c! P8 e6 G% M. j( c4 S) I3.2 开始移植
8 w7 t: d- ^; z& B4 _/ \将整个STemWin目录拷贝到工程目录下:
) o  A1 W0 \: Q
: A9 V. l; y" b  Q; E& Y# l

1 f1 I9 Y( o5 n' L+ n0 S/ I
, Z* W! G2 v& O* T% r& Y' u打开LCD Demo的工程文件，将STemWin下必要的文件添加进工程，具体文件以及路径如下：

5 Z5 E- N" E/ MSTemWin/Config/GUIConf.c
STemWin/Config/GUIConf.h
+ h" T* F! @% B( u# @# ]$ gSTemWin/Config/GUIDRV_Template.c
STemWin/Config/LCDConf_FlexColor_Template.c
6 d7 l& g% ~+ n, h% M! d& N8 z$ J6 j+ ySTemWin/Lib/STemWin_CM7_wc16_ARGB.a
, I  n/ Q) c: rSTemWin/OS/GUI_X.c
添加完成之后，工程目录结构中如下：

# [' W; t, L3 p* d: B  R将STemWin_CM7_wc16_ARGB.a设置为库文件，具体配置方法如下:

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

$ F. ^9 D3 j" M) w4 ]' X3.3 修改代码
! Y, x9 b# v$ `0 K7 q3.3.1 修改LCDConf_FlexColor_Template.c
. r' ], V' @+ r" {- P( z! M; t3 A找到XSIZE_PHYS和YSIZE_PHYS，并修改为实际LCD的分辨率

, [! o8 a7 d: i: E3 ~0 K6 l
修改LCD_X_Config(void)，具体修改为
7 i0 m8 B7 W6 l8 N. j) {
" W( ^7 s7 j( _" g7 b

. L7 B" B" {- f/ o
修改LCD_X_DisplayDriver(void)，加入我们自己的LCD屏的初始化函数。

' ^  ?! n* \3 Z% U4 |
2 ?# y; @( m. Y修改一下几个函数，该方法根据具体使用的LCD确定，本例程使用的是SPI通讯的LCD屏幕，指令和数据均为 8 bit
8 A. b9 F$ W$ h/ ^/ Q( T
& e" y; t: T4 l9 kLcdWriteReg(U16 Data) —> LcdWriteReg(U8 Data)
9 l, M1 t- G. X3 w! dLcdWriteData(U16 Data) —> LcdWriteData(U8 Data)
LcdWriteDataMultiple(U16 * pData, int NumItems) —> LcdWriteDataMultiple(U8 * pData, int NumItems)
9 I! D& h7 U' m* H0 T
: ?0 C3 M, `% _9 X

% r' u* k2 F4 `3 W. G5 U3.3.2 修改GUIDRV_Template.c
找到 ，加入LCD的画点函数，该函数由LCD驱动 Demo提供，需要根据自己的LCD驱动代码来进行添加。

& K, a. ]0 W1 n: x4 ]

* ]$ t7 y1 t* P3.3.3 修改GUConf.c
修改GUI使用的SDRam大小

: K3 m) Z! t. c* e6 C0 F

3.3.4 新建一个空文件 LCDConf.h

/ X$ |' }! H% W+ Q' }3.3.5 由于采用的是RGB格式的LCD屏，因此需要修改GUI_ConfDefaults.h，否则可能会以BGR的方式显示。
! A4 a& i5 k0 V/ D6 e- ]# b
. I3 d. r; p% {' N& G

3.3.6 修改stm32h7xx_it.c中的SysTick_Handler函数，加入一下代码，由于GUI_Delay会使用到OS_TimeMS，因此如果不加该段代码，GUI_Delay将无限延时
& Q# |# }4 k# m: \) I2 |

3 u+ `( L- I+ A1 J1 C1 P
7 `4 [0 t+ v+ z) ~2 f# I, v- f2 x4 验证
在main方法中，包含头文件GUI.h，并加入测试代码

( y( Z4 E- |5 O7 g; B# z

实际显示效果：

' h0 R9 O& }) H- c2 L& U' e
5 总结
% c* U; Z, y5 d1 H. D对于一名没有用过STemWin的小白来说，移植还算顺利，比想象中的要Easy一些，中途参考了各方教程，并结合自己的理解，完成了这一次移植。本次移植采用的是GUIDRV_Template_API的方式，后来也有使用GUIDRV_FLEXCOLOR的方式移植了一下，这个后续有空再补。

# i6 v3 k/ _& _" P