01

前言

STM32CubeIDE的工程联调功能太好用了，特别是调试BOOT和APP的场景下，可以让大家清楚的看到程序是如何一步一步的从BOOT跳转到APP的，强烈的视觉冲击，让人眼前一亮，拨云见日，让bug无处遁形。

02

准备

刚好手上有一块STM32H563的NUCLEO板，那我们就基于该开发板来一步一步展现IAP工程联调的美妙吧。首先通过STM32CubeMX准备IAP的BOOT和APP的示例工程。


2.1. 制作BOOT工程


BOOT工程我们准备了常规的LED点灯程序，我们使能了ICACHE，配置了外部按键中断（并使能中断），以及板子上的三个LED灯（GPIO output），如下图所示。
- }% r3 I& V" N) D" O

$ T4 n& t- U5 r0 M/ r: b

▲ 图1. BOOT工程STM32CubeMX的配置

* n$ V. C: Z0 {0 P在生成的工程中，我们添加了按键检测，如果有按键按下，则进入IAP的跳转流程中，如下图所示。


- A/ t1 S6 g; R* f6 e+ p

▲ 图2. BOOT工程中的跳转代码

" d; ~- R3 c3 k* Q$ k( c0 V
$ L) |" e/ }( W5 e上述代码涉及到的变量定义和函数的实现如下图所示：

▲ 图3. BOOT工程相关的变量定义和函数实现

1 e/ E1 e- A. \+ a* ?: q/ [
! B( D+ Z& U# _* W/ @- G2.2. 制作APP工程
; \% a) S, C" s% S, l5 `$ `
APP工程的基本配置与BOOT工程完全一样，可以直接导入BOOT工程的STM32CubeMX的配置，故在此不重复展示。
5 i: P2 w* O- l

3 `9 P9 A( h' ]1 ]' `在STM32CubeMX生成的工程中，APP工程还需要修改内存分散加载文件，以适配APP工程的内存偏移，如下图所示。
8 z7 x2 s# @; u+ U
  ?, `$ d0 l4 S  M0 ~/ D6 C. T: p2 Y

▲ 图4. 修改APP工程的内存分散加载链接文件

7 h4 X0 x% G) W4 u' V# Z+ R* u+ D# T修改代码里中断向量表的偏移地址，如下图所示：

▲ 图5. 修改APP工程的中断向量表偏移值

在APP的主循环中添加LD3的闪灯程序，如下图所示：
; ]3 y2 l' K  H6 ]+ h! {
) @* g1 i% k% a( h' C
: T0 R8 y  q6 E( M

▲ 图6. APP工程的主循环

03

调试配置

& h/ _6 J; s5 M' W

准备好工程后，接下来我们就可以配置BOOT工程的调试选项了。在BOOT工程的调试选项中，新增APP工程的调试配置，如下图所示：

▲ 图7. BOOT工程的Debug Configuration选项

% ^' Q! g( [) M5 k- d, Z注意：这里的Step5中，我们去掉了“Perform build”和“Download”两个选项，目的是仅仅加载APP工程的symbols，不需要重新编译和下载工程。如果勾选这两个选项，调试器建立连接时，会产生错误。
0 E5 }: K& u$ F

添加完APP的调试配置后，会在BOOT工程的调试选项中看到如下图所示配置：
  q/ k  e' J8 \2 _  R: j7 k( x
: E; S& d6 M% n4 ~9 E' O* k1 K

▲ 图8. BOOT工程的完整选项

! O! D5 p  b9 ~4 ~. A6 ~
' n) i6 p% p9 K5 S( z1 ]在演示工程联调之前，我们先通过STM32CubeIDE下载APP的工程（在APP工程的Debug configuration中下载程序，或者通过STM32CubeProgrammer下载），然后再通过BOOT的调试选项进入到调试界面。
! Z% H  z5 n7 ~! a
: `; F4 j6 k- I( H: P
% T9 s3 l: B9 [4 t$ ^: [9 ~我们可以在BOOT工程中设置断点，同时也在APP的主循环中添加断点，然后运行程序，可以看到LD1在闪烁。

2 }# E+ \& n' \" c0 J4 ~
" P6 D7 v3 Q1 {9 C此时按下开发板的蓝色用户按钮，可以看到LD2也会点亮1秒钟，然后工程停在BOOT工程的断点处。

8 D5 y2 q) g; }3 B. y, a$ N  P8 X
2 j0 ]! A) E! S* L" m在调试界面，我们配置调试为汇编单步执行，如下图所示：

▲ 图9. 配置APP工程的汇编单步执行

& _) B  v' S' k6 o: J# P# k; j. q
这样我们就能清晰的看到程序从BOOT跳转到APP工程的Reset_Handler程序了。如果继续全速运行，可以看到LD1和LD2熄灭，LD3在间隔500毫秒闪烁。
6 w+ V  g+ w- L8 O& X7 b

5 {5 _2 K( @# _! F7 Y: l- l

04

小结

这里我列举出可能会出错的地方，方便大家顺利实验。

$ I. X( a, l7 d& z" Z, Q7 M
1. 在准备好BOOT和APP的工程后，需要先通过STM32CubeIDE将APP的程序下载到开发板上。
2. 本文档中的演示示例，BOOT工程在跳转到APP代码之前，需要失能ICACHE，因为在APP工程中，ICACHE的初始化函数如果判断到ICACHE是激活的话，会直接进入到错误处理函数，造成APP代码无法往后执行。
# M( T8 v) c9 ?  h
( L$ J3 ?7 N4 C: O' @" S