1. 前言 在阅读 UM1718 文档的时候，发现 CubeMX 有个比较好的功能，可以用“.extSettings”文件配置生成代码的工程文件结构。只需要要配置“.extSettings”文件一次，后续不管使用哪个IDE（只要是 CubeMX 支持的），都不需要再手动配置文件结构或包含头文件路径了，并且可以保持对各个 IDE（只包括 CubeMX 支持的）配置的一致性，减少工作量。也有客户询问怎么添加工程文件的问题，考虑到可能有些同学不太了解这个功能，所以本文对这个功能进行介绍。
5 A; C8 h" ?% P: w" e' ~/ g/ ]1 \2. .extSettings 文件的作用
2 N7 @4 ^/ |, A$ G “.extSettings”文件是对 CubeMX 配置的补充，是在 CubeMX 配置的基础上进行的额外配置，不是替换 CubeMX 的配置，这点需要注意。
; R! E0 Z3 I# H总体来说，“.extSettings”文件中的配置包含三部分，分别是[ProjectFiles], [Groups]和[Others]，下面分别对这三个部分的功能进行介绍。
4 @6 w3 S8 E) l3 o" a4 X
/ u- V% c& i+ P5 {5 J
+ l5 C6 R$ g2 F7 p; a& v: Y3 F# V2.1. [ProjectFiles]
[ProjectFiles]这个部分主要是用来包含一些目录，例如头文件存放的目录。
0 i! n5 ^* U6 D# P$ t4 v8 A语法：HeaderPath= ;  
# ^. n& W5 z/ D示例：HeaderPath=../BSP/STM32H735G-DK
! i, e# ~: k: N1 J; S) s说明：这里的路径是相对于“*.cproject”或“*.project”文件(如果生成的是 CubeIDE 的工程代码的话)的相对路径。如果生成的是其他 IDE 的工程代码，则这个路径是相对于其他工程文件的相对路径，例如“*.eww”文件(IAR)或“*.uvprojx”文件(KEIL)。
效果：在“.extSettings”文件中添加示例中的内容，重新生成代码后，效果如图 1，红框部分是通过 “.extSettings”文件包含的目录，可以看到已经被包含到工程中。
! M: ]5 }% }" Z2 }* ?, a


" O" `/ D" Y0 t+ A/ t9 L

2.2. [Groups]
这个部分主要是用来在工程中创建文件组并且将文件添加到文件组中，用来组织工程的文件结构。
* }) I2 B- m* [7 j, u语法： = ;< file pathname2>
5 p! X" Z& E& t6 Q: z/ ]7 ?+ \8 N示例：Drivers/BSP/STM32H735G-DK=../BSP/STM32H735G-DK/stm32h735g_discovery.c;
说明：是工程中的文件组名（若不存在则会自动创建）；是文件路径。示例中语句的作用是，嵌套创建“Drivers/BSP/STM32H735G-DK”这个文件组（可以多级嵌套创建），并且将“stm32h735g_discovery.c”文件添加进这个文件组中。可以在一个文件组中添加多个文件，只要多个之间通过分号（“ ;”）隔开即可。 效果：在“.extSettings”文件中添加示例中的内容，重新生成代码后，效果如图 2。

  W2 M9 ~) [; S6 K. y, I1 I



2.3. [Others]
[Others]这个部分主要是用来使能一些 HAL 模块和添加一些预处理定义语句。


0 M7 H. P8 |, p4 w9 t- z6 A2.3.1. 添加 HAL 模块。
语法：HALModule = ; ;
- O( M% k. J! S7 I& j" t2 o示例：HALModule=SPI;ADC;
效果：在“.extSettings”文件中添加示例中的内容，重新生成代码后，如果使用 H7 系列的芯片创建的工程，则会自动在 “stm32h7xx_hal_conf.h”文件（如果是其他系列的芯片的话，名字会略有区别）中添加“HAL_SPI_MODULE_ENABLED”和HAL_ADC_MODULE_ENABLED”这两个宏定义，作用是在这个文件中包含 SPI 与 ADC 的头文件。如图 3 所示：
8 s& t: Y' l7 J& q6 A
4 s4 X/ H$ ^/ U9 I- j/ s8 Z

2 L( l- ^; s9 ~; x4 `4 v
) n, C: ^' A; e( ^
$ W, o" F1 v% c% o6 u 2.3.2. 添加预处理定义语句
2 B+ P  U4 z$ u) K6 b语法：Define = ;
; n: O- @' A3 \* B# x4 j; O示例：Define=TEST_STM32H735G_DEMO
/ J! \' _: |6 C0 ^' F效果：在“.extSettings”文件中添加示例中的内容，重新生成代码后，可以看到在“.extSettings”文件中配置的预定义语句已经被添加到工程中了。
, L; g- |8 G/ k5 o- d0 X




3. 使用实例
下面的实例基于 STM32H735G-DK 板，使用“STM32Cube_FW_H7_V1.10.0”中的BSP 驱动。要达到的目的是使板子上的 LED1 每隔 0.5S 切换一次亮/灭状态。下面是实现的步骤：


- W3 D+ Q; z# k- l3.1.1. 创建 CubeMX 配置文件
% e8 X- y% o5 g: c5 O使用 STM32CubeMX 创建 STM32H735IGK6(STM32H735G-DK)的工程，其他配置都使用默认值即可，并保存这个配置文件。如图 5 所示：
$ a  t1 V; i6 Z) W1 H. {+ W7 A% h
- d- g  R* m9 S% N8 W
) B* f$ x/ G" j/ Q. [0 S


5 ?+ d0 {8 F) H. O" Z+ V 3.1.2. 添加 BSP 文件
% I1 w8 P  q8 n& R3 o, S% Y6 p 将“STM32Cube_FW_H7_V1.10.0/ Drivers”路径下的“BSP ”目录及其文件都复制到工程目录下（这里是复制到.ioc 文件相同目录下，您也可以根据自己需要复制到其他地方，只要在“.extSettings”文件中包含即可）。如图 6 所示：

, h7 ?- p) c* c8 @


9 @1 Q: F  A8 d7 |
( T! M* J( }1 _0 ]" h; w4 P& Z修改 BSP 中“stm32h735g_discovery_conf_template.h”文件的文件名修改为“stm32h735g_discovery_conf.h”


8 W8 e: f. M5 q) {5 M" p

5 r, \  u, b3 P" O# j; x完整版请查看：附件

# A6 h. Q+ B" \0 Y, y1 [
$ U- U! Q' z2 P/ J% v! `: Z

楼主，附件在哪里？能不能给一个写好的模板参考一下？