01
前言
  p, C* ~' r  O8 f- k' E$ Q8 k某客户在使用 TouchGFX Designer 4.22 创建 TouchGFX GUI 应用时，使用 STM32U599 开发某款 GUI 产品，用 STM32CubeIDE 作为 IDE 发现无法下载成功，每下载到 93% 时就停滞并且报错。然而，如果选择 IAR 作为 IDE 则可以成功下载和仿真。客户表示当前使用的 STM32CubeIDE 已经是最新版本，同时也尝试过使用更老的版本或创建其 他的 demo 应用均是同样的结果。
/ a1 A* H+ D, G, v* d
02
# Q* M/ w* L: P. |9 Y3 {. l- c+ A现场调研与问题复现
8 h- D/ z8 p4 H0 I经现场询问，客户板子外扩了 NorFlash，怀疑可能是 Flash loader 或 NorFlash 硬件存在问题。首先通过 OSPI 裸机程序对 NorFlash 进行读写访问均正常，排除硬件故障。进一步询问客户表示 NorFlash 硬件采用了与 STM32U599J_DK 一样的接法。因此，采用 STM32U599J_DK 板子的 Flash loader 肯定是可以的，现场使用 STM32Cubeprogrammer 选择 STM32U599J_DK 板的 flashloader，对客户板子外部 NorFlash 进行读写操作均能操 作成功，说明 NorFlash 确实与 STM32U599J_DK 接法一样。

$ _+ A$ a% h$ a. b3 g" ?STM32CubeIDE 下载错误提示如下图所示：
- P2 e) [- O( @' @$ i

03
) y5 Z% W0 v; m% s0 K; D问题分析与解决
: m7 |5 k7 Q( C0 x5 q) B既然使用 STM32Cubeprogrammer 都能够正常下载，那么 STM32CubeIDE 按道理肯定也是可以的。经过跟踪编译过程发现，STM32CubeIDE 与 STM32Cubeprogrammer 使用的下载文件是各自独立的。也就是说 CubeIDE 并没有使用 STM32Cubeprogrammer 安装路径下的 bin 目录下的 STM32_Programmer_CLI 和相关资源文件。CubeIDE 下载使用的 bin 路径为：STM32CubeIDE_1.14.0\STM32CubeIDE\plugins\com.st.stm32cube.ide.mcu.externaltools.cubeprogrammer.win32_2.1.100.202311100844\tools\bin\STM32_Programmer_C LI.exe
: e9 D7 X! G/ i: q! L, P3 [% `) @
找到 CubeIDE 安装路径下的 Flash loader 目录：
# u0 }8 C, s  v& [/ h( v, c& K

在 ExternalLoader 目录下只发现了一个 STM32U599J_DK 相关的 Flashloader， STM32U599J_DK 应该就是使用的这个 Flashloader 文件。
" W- v; n5 P9 _& ^4 j
再次比对核实用户所创建的 CubeIDE 工程所用的 Flashloader：
. K, W5 g( z! r' Z5 N6 I0 F* }7 w6 Y

原来 TouchGFX designer 所创建的 project 所使用的 Flashloader 名称为 MX25LM51245G_STM32U599J-DK.stldr，而在 CubeIDE 安装路径下 ExternalLoader 里面的名称则为 MX25UM51245G_STM32U5x9J-DK.stldr，二者名称不一致，使 CubeIDE 无法成功加载 FlashLoader，导致下载出错。问题原因已经找到，通过修改 CubeIDE 中 FlashLoader 的配置即可解决此问题，具体修改方式如下：

修改后，测试下载与仿真均正常。
2 K( n6 v+ `6 x7 Q& C) T
/ c, t+ a4 V4 ?6 ~+ v$ p/ K/ w04
总结
( `! F2 Y: c) w3 S2 g由于在 MCU 上运行的应用程序越来越复杂，因此，对于在片外 Flash 运行代码的需求越来越多，特别是针对 Flashless 形态的 MCU 都需要用户自己开发 Flashloader，建议用户使用与开发板一样的硬件接法。这样，就不必自己去重新开发 Flashloader 了。

: g+ @" A. J% q
; r( s  v5 [0 R; N7 [

▼▼▼

点击按钮下载《基于 STM32CubeIDE 下载 TouchGFX GUI 应用的出错分析》原文档。

点击下载