你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

基于STM32的TouchGFX从旧版本更新到新版本的方法

[复制链接]
STMCU小助手 发布时间:2023-11-4 14:23
01引言& }  l& }9 j# q7 a
随着 TouchGFX 不断进行软件版本更新,其提供的功能也越来越丰富,有些新的功能只有更新的版本才有,所以很多时候会面临将旧版本的 TouchGFX 迁移到更新版本的问题。在创建 TouchGFX 应用时,生成的.touchgfx 工程文件版本与用来创建应用的TouchGFX Designer 版本相同,TouchGFX Designer 在设计上是向后兼容的,您可以使用更新版本的软件来开发您的应用。在大多数情况下,仅需一个极简单的流程便可使旧版本应用能够工作在 TouchGFX 新版本上。
& b' m2 i' g0 W* c7 a
3 |+ y" Q0 Y. A8 x8 f* H: }( {+ `本文档提供了如何从较旧版本的 TouchGFX 升级到较新版本的教程,总结可能发生的常见问题及其各自的解决方案。本文档可能并不详尽,可能在将来进行更新,但旨在解决用户在版本更新时遇到的大多数问题,以确保顺利过渡到最新版本的 TouchGFX,从而享受最新版本的 TouchGFX 功能。
/ z0 C& [0 a- D5 j$ T3 I) e! h( y( r
02TouchGFX软件升级安装
+ _) y$ G! x7 J' `5 A1 NX-CUBE-TOUCHGFX 是 STM32Cube 生态系统的一个软件包,它包含以下组件:TouchGFX Designer,TouchGFX Generator 和 TouchGFX Engine,其中 TouchGFX Designer 是用来构建 UI 的 GUI 构建工具,TouchGFX Generator 是通过 STM32CubeMX来生成用户 TouchGFX HAL 的工具,TouchGFX Engine 是驱动 UI 应用程序的TouchGFX C++框架。软件升级所涉及到的主要是 STM32CubeMX 中 TouchGFX Generator 插件升级安装和 TouchGFX Designer 升级安装。# N# t8 ]' v7 @* l6 p

0 B- p$ A! q9 @; }2 m+ {5 f4 J- j2.1. 安装新版本 TouchGFX Generator3 @* R( T, V. _5 I
打开 STM32CubeMX 软件,点击菜单栏“Help”下的“Manage Embedded Software Package”,或者按键 ALT + U,进入到软件包列表。
- o7 r$ T' @  [. o0 G7 X
5 U; t. r' D8 v  O- N
7 u; ~* S& d! [2 `/ e* H
微信图片_20231104141335.png
图1.点击菜单栏“Help”下的“Manage Embedded Software Package”
" s8 j3 t4 ^& G% Q7 u7 M' I0 l5 U
进入软件包列表后,单击“Refresh”以获取有效的可更新的软件包列表,此操作需保证电脑网络连接正常。
" \' Q- [5 ?- F0 ^
+ _5 Z: o% x8 w+ h
# B! n% V8 T# e7 R2 Z# N) V3 Y

- G6 n: `4 M  e5 }: j3 D
微信图片_20231104141332.png
图2.STM32CubeMX 中的软件包列表
6 g% D/ p9 g0 k' _
然后转到“STMicroelectronics”选项卡, 滚动直至找到“X-CUBE-TOUCHGFX”,然后展开节点,选中最新版本“TouchGFX Generator 4.20”复选框,然后点击“Install ”,此时将下载软件包并显示许可协议。. n2 g# `- A* k) J
7 F! O% ?* r- T3 X- u

7 p" Z, i/ g, i) d: t. f
( X( V* @% y: V; Q- {, S

+ c" _5 ?+ X( i# r
微信图片_20231104141329.png
图3.安装好 TouchGFX Generator 4.20 后的界面
5 f' p' V7 D1 Q2 o. c% f
2.2. 安装新版本 TouchGFX Designer
3 B6 R" W, x9 [& r$ _" P- a! F在类似路径
1 W8 p* G+ s- E- ?  MC:\Users\\STM32Cube\Repository\Packs\STMicroelectronics\X-CUBETOUCHGFX\4.20.0\Utilities\PC_Software\TouchGFXDesigner 找到 TouchGFX.msi 安装程序,双击 TouchGFX.msi 文件可打开安装程序,按照说明完成安装过程。路径根据您的安装路径略有不同。 ( j1 J1 _) A7 j$ h' P9 {
. i) H6 @  @) Q1 n3 U

8 f8 K# m+ X% T/ R% z
微信图片_20231104141326.png
图4.开始安装 TouchGFX Designer 4.20
0 |% R3 g/ y* u

& o3 q: X( h  A- T+ L4 j% F4 i! h' X+ V2 t' L
03工程项目由旧版本迁移到新版本TouchGFX
3 v# T, ~1 S0 c/ j安装好新版本的 TouchGFX 软件后,下面介绍将您的工程代码迁移至新版本TouchGFX 的方法。一个完整的软件工程升级到新版本包括 STM32CubeMX 中TouchGFX Generator 配置升级并生成代码和使用新版本 TouchGFXDesigner 打开文件并生成代码。! k4 F. ^, h' `. j( i/ n% Z

7 J) i+ J+ G0 q8 T( w# b- r* ~3.1. STM32CubeMX 中 TouchGFX Generator 配置升级( s9 a/ o5 \3 H
3.1.1. 使用最新版本 STM32CubeMX 打开旧版本的.ioc 文件2 d" Q/ M6 E' r6 c  C( |  K
使用最新版本的 STM32CubeMX 打开旧版本的.ioc 文件,CubeMX 会弹出类似如下的窗口。在项目加载时:STM32CubeMX 会检测该项目是否使用该工具的旧版本创建,如果是,则会建议用户迁移,以使用最新的 STM32CubeMX 数据库和 STM32Cube 固件版本,或者继续。点击继续将保持用于创建项目的数据库不变。如果计算机上没有所需的数据库版本,则会自动下载该版本。升级到 STM32CubeMX 新版本时,请确保在加载新项目之前始终备份项目(特别是当项目包含用户代码时)。+ W5 c+ ]' i$ s! o# O

" |. K: ~% i: F9 ]6 ~

& b* H1 h: x" c8 m# Z: V
微信图片_20231104141323.png
图5.STM32CubeMX 加载工程
9 _" r  W! p3 {& x) |. X' E3 C
微信图片_20231104141250.png
图6.点击 Migrate 进行工程迁移
5 \* w* _# q* x& ^. p$ p$ C1 ?
3.1.2. 在 STM32CubeMX 中更改 TouchGFX Generator 版本0 s3 A1 {) L9 N1 n4 ~7 ^6 r3 I' k  N
在 STM32CubeMX 软件中,点击 STMicroelectronics.X-CUBE-TOUCHGFX.4.20.0 进入 TouchGFX Generator 配置界面。在开始升级软件版本时,请首先截图保留以下配置,以方便后面对照更新配置。
9 u7 N  B& J6 ?
1 L# m3 ?" i/ Q; @8 M2 A- q& a
" u9 F" A2 O: C9 P, N$ \6 w2 N
微信图片_20231104141247.png
图7.截图保留原 TouchGFX Generator 配置
' F) M/ r8 D6 T; _( Z- [
点击 Software packs 选择 Select Components ,在部件选择窗口,取消选择旧版本TouchGFX Generator,然后再选择最新版本的 TochGFX 4.20(或者将来更新版本)。当TouchGFX 4.20 被选中后,需要通过选择 TouchGFX Generator 来应用它。
6 z( m1 E9 @* C( j2 h4 }& ~( h, n3 N+ C% L; w3 |) u5 r
微信图片_20231104141244.png
图8.更改 STM32CubeMX 中 TouchGFX Generator 版本的步骤
9 j8 R! [, B; \; W; q
3.1.3. 更新 TouchGFX Generator 配置参数
, m0 ]$ c+ K% I& U3 _9 W  l* `1 c回到 TouchGFX Generator 配置界面,我们使用以前版本图 7 中的参数配置新的TouchGFX Generator,最后点击生成代码。
3 l2 O! O. }) j/ D5 Z0 f* z. X2 R+ i2 N, M- A
4 q4 b/ e! ]$ _; u0 A6 n

* J* _. r8 X* @$ E3 h+ B
微信图片_20231104141240.png
图9. 更新 TouchGFX 配置和生成代码

. t; b7 l, J: k5 i7 A) I忽略以下 warning, 点击 Yes。: `1 D9 M2 k( j- r" \2 ~5 d

9 i$ F; {( r  t, @8 k7 w
微信图片_20231104141237.png
. d: o% y0 L8 y' x/ L/ t* j- h, _$ W
3.2. 使用新版本 TouchGFX Designer 打开 .touchgfx 文件生成代码
5 S3 ~: G$ P4 P- H( S7 Z右键单击 .touchgfx.part 文件,然后选择最新的 TouchGFX Designer 打开,您将收到一个弹出窗口,要求您确认更新,请点击“是”。 3 C( _. C& c4 X5 e; d% o9 c8 b

# O/ j& D7 c; a9 B+ Z1 U8 w; T; \然后,您需要先删除 build 和 generated 文件夹,再重新生成代码。执行此操作后,需要在 STM32CubeMX 中再次生成代码。此时可以使用您的 IDE 来编译项目,并查看是否有任何错误。
- U2 s$ _5 z) B% O  Q8 O, a
8 K5 O# f6 q3 I+ I5 X2 z% V
微信图片_20231104141234.png

4 J! ~: T2 x9 P0 v) X- |
微信图片_20231104141231.png
图11. 选择最新的 TouchGFX Designer 打开.touchgfx 文件
0 A# g6 K# W: O0 V: C0 n9 I

& M! q: }8 J: P9 @3 I  j: m7 R# o4 ?
- d6 M6 Z3 H; ]04软件升级遇到的常见问题
' t- J5 N' [/ u7 V在软件版本升级之前一定要备份自己的软件工程,这是十分重要的。在将旧版本的TouchGFX 工程迁移到新版本的过程中,有以下事项需要检查确认:+ p, a5 d! a! z0 A5 M# N5 {: N4 h
(1)使用新版本 TouchGFX Designer 生成代码之前,是否在 STM32CubeMX 中使用相同版本的 TouchGFX Generator 并生成代码?如果您使用 TouchGFX 4.20,则需要在STM32CubeMX 中使用 TouchGFX Generator 4.20 和 TouchGFX Designer 4.20, 版本要保持一致。STM32CubeMX 的版本要选择支持 TouchGFX Generator 最新版本的版本,例如,要使用 TouchGFX Generator 4.20,那么 STM32CubeMX 的版本要最低为 6.5。
" z! f, h& J4 h7 T" y& J% @0 d+ O
$ y$ y4 V/ G( T& g' x- F

2 T0 E, e7 {2 m2 Z0 q(2)检查代码中是否缺少#include 行。使用某些功能时,保证始终在每个文件中包含正确的路径。3 z- J. |$ i3 m3 o4 h; u- L- X

7 a# t9 Q, M2 Z. ?/ r  Q8 o

4 {* |; V$ E4 n! Q3 n(3)检查您使用的函数是否已被弃用,或者是否更改了名称。您可以参考帮助文档中的更新日志页面。. F% Y- n$ J) K9 W' z3 p, o7 j- ]

' e, O& X/ K  O- W! q9 c
/ v* }; a7 @4 s3 k
(4)建议使用 STM32CubeMX 单机应用程序,而不要使用 STM32CubeIDE 中的STM32CubeMX。因为在 STM32CubeIDE 使用 STM32CubeMX 进行升级会遇到更多的问题。
) U4 X/ X5 J: i
/ O- @$ ?- X4 p1 p$ f6 k$ N

" ?& [, [) m* r; ]- A(5)升级结束后,在重新编译代码之前,Clean 你的工程和去除之前编译的目标文件。
: R. T0 d6 V; d) d7 F, }- v9 g- y8 g0 a* n+ O& b0 C5 v

- T$ C& a1 n/ R0 u; |% g(7)在迁移之前,请确保您没有用户代码部分之外的代码,否则您的代码将在代码生成后被删除。
' ], w9 m0 c4 E
6 L% s, g! j. x6 K4 K$ q
, ]4 W/ M5 w/ I5 e1 L
(8)TouchGFX/Target 文件夹将在迁移后被修改,因此您可能需要将以前的代码复制粘贴到新创建的文件中。" L0 _5 p; ?5 e9 @$ {( J; ^
& F$ G+ o' u. L* q( z6 U

$ d# z6 x2 o' t" O, H+ p3 F(9)TouchGFX 设计团队已经列出了 TouchGFX 版本中已知存在的问题,以及可能的解决方法。( M, t9 H) e+ @7 @3 |* z, G
8 |. R* v! h+ C, B  M' R) g
+ g' l* o9 V9 ^6 w# e  ]
转载自: STM32单片机
2 b# M- v& ]3 ]! F0 A( s7 U
" i# i- K' M8 ^/ }0 o! Y; G如有侵权请联系删除' o; `* H/ N. v9 Z1 Y
* H$ ]0 ^  A: e
9 e6 z! B7 Y5 S/ W) v
赞 收藏 评论0 发布时间:2023-11-4 14:23

举报

0个回答

所属标签

相似技术帖

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版